Re: Documentation - language default

[Sriram Ramkrishna <sri ramkrishna me>]

On Wed, Apr 4, 2018 at 1:37 PM Bastian Ilso <hougaard junior gmail com> wrote:

From newcomer guide POV, the major blocker for us to start in writing _javascript_/python/etc documentation is having a modern central online place/platform to write, edit and store the documentation in. GNOME Developer Center really needs a helping hand. To assess requirements for such a platform, I want to propose we organize a hackfest and make a plan.

That's sounds good to me.
 

I already wrote a proposal draft, we just need to find some good dates for it. Maybe I should start a framadate? Quick thoughts arrive at maybe before/after GUADEC.

Works for me.  Can you post on our telegram channel?

Also one postscript to the original mail - since I had some feedback on IRC as this approach might create more noise than anything that would be educational for us.

The point of the post is not create language wars.  It's to figure out which language to focus on initially.  We can add documentation for other languages as well.

This discussion is not about which is the default language to use in GNOME.  What we document right now is not an endorsement of that either.  I just want to make sure that we have minimal requirements in place on the state of gjs, builder, and that there is a cohesive whole to start documenting on.

IF you want to discuss language wars, please don't.  If you want to get something off your chest, feel free to pm me or discuss on IRC.  I'm not interested in creating undue conversations that will have no end.  So please think before responding that it meets the topic of this conversation.

sri

-Bastian

On Wed, Apr 4, 2018 at 8:39 PM, Sriram Ramkrishna <sri ramkrishna me> wrote:

Some of you may be aware that we have started a documentation effort in order to give application developers a proper set of documentation for them to write applications.

We need to optimize for one language rather than promoting all the languages.  In the past, we have promoted _javascript_ above all else.  We haven't seen as much movement in  _javascript_ allegedly because the toolchain has not been as robust as the other languages.

Since this conversation could easily get derailed, what I would like to focus on is using _javascript_ as the default computer language for developing 3rd party apps on the GNOME platform.  We would like to validate what the current state of _javascript_ is for writing applications and whether we now have good support in flatpak, debugging toolchains (eg gjs and builder) and other factors we might have not considered but should be identified.

Any input in this regard would be well appreciated to drive good documentation to write applications for the GNOME platform.

Thanks,

sri