Re: Documentation

[Sriram Ramkrishna]

On Feb 1, 2014 4:09 PM, "Matthias Clasen"  wrote:
>
> Hi,
>
> if you're following git, you may have noticed that Jon and me have quite
a few commits that only touch documentation, recently. I thought I should
explain here what we this is about: We are trying to improve the developer
documentation for application developers.
>
+1! This is great news!

Really happy to see this.

Sri

> The reference documentation for the GTK+ stack may be extensive, but it
is not easy to navigate and hard to make sense of if you are e.g. writing
in JavaScript and are not comfortable translating from C to JavaScript in
your head. The need to improve this situation has been discussed
repeatedly: at the developer experience hackfest a year ago, and more
recently at the Montreal summit. Now its time to do something about it !
>
> Our short-term goals are to
>
> - Make the doc comments more readable by moving from clunky docbook markup
>   to markdown. This will help both for reading and updating the
documentation in
>   the sources, and for limiting the scope of whar our
documentation-generating
>   tools need to parse when generating online docs.
>
> - Move from clear-text (like "free with gdk_rgba_free()") to annotations
as much
>   as possible, so we don't tell JavaScript developers about memory
management.
>
> - Add language annotations to embedded examples.
>
> - Generate the action (function-level) reference documentation with
g-ir-doc-tool
>   from the gir
>
> We've started with GTK+ and GLib, but this effort should be easy to
extend up and down the stack from here. Help is more than welcome!
>
>
> Matthias
>
> ___
> desktop-devel-list mailing list
> desktop-devel-l...@gnome.org
> https://mail.gnome.org/mailman/listinfo/desktop-devel-list
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-devel-list

Re: GTK+ hackfest 2016

[Sriram Ramkrishna]

We are hosting a GNOME conference in Portland in September.  Would you like
to do it then?

Sri

On Mon, Mar 7, 2016, 2:04 PM Behdad Esfahbod  wrote:

> Hi Matthias,
>
> Any idea why the page says Immutable to me?
>
>   https://wiki.gnome.org/Hackfests/GTK2016
>
> I remember having seen this before but don't remember what the resolution
> was.
>
> Cheers,
> behdad
>
> On Tue, Mar 8, 2016 at 5:02 AM, Matthias Clasen  > wrote:
>
>> Hi,
>>
>> we've discussed the idea of doing a GTK+ hackfest this year. I've
>> started a wiki page with the current plan:
>>
>> https://wiki.gnome.org/Hackfests/GTK2016
>>
>> If you are interested in attending, please add your name to the list.
>> If you want to see topics added to the agenda, please suggest them on
>> this page, too.
>>
>> Hope to see some of you in Toronto!
>>
>> Matthias
>> ___
>> gtk-devel-list mailing list
>> gtk-devel-list@gnome.org
>> https://mail.gnome.org/mailman/listinfo/gtk-devel-list
>>
>
>
>
> --
> behdad
> http://behdad.org/
> ___
> gtk-devel-list mailing list
> gtk-devel-list@gnome.org
> https://mail.gnome.org/mailman/listinfo/gtk-devel-list
>
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-devel-list

Re: GTK+ hackfest 2016

[Sriram Ramkrishna]

On Tue, Mar 8, 2016 at 4:48 AM Juan Pablo Ugarte 
wrote:

> On Tue, 2016-03-08 at 07:40 -0500, Matthias Clasen wrote:
> > >
> > > We are hosting a GNOME conference in Portland in September.  Would
> > > you like to do it then?
> > Thats an interesting alternative, worth considering.
> >
> > My initial thoughts are:
> >
> > - It does push us late in the 3.22 cycle, which is a bit of a minus
> > for the 'planning next steps after 3.20'
> > - Can you get us a venue ?
>

Yep, I have a venue already reserved, at the Eliot Center for 5 days from
Sept 19 - 23rd in Portland, OR.  I already want you all there anyways.
;)The opensuse guys will be there too doing their code sprint we are joint
hosting with them.


> >
> > What do others think ? Too late ?
>
> I agree it would be too late for 3.22, but it would be pretty good for
> 3.24! :D
>

Definitely good for 3.24!

sri
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-devel-list

Re: GTK+ hackfest 2016

[Sriram Ramkrishna]

On Wed, Mar 9, 2016 at 1:26 PM Matthias Clasen 
wrote:

> After considering the scheduling and the topics for a bit, I prefer to
> keep the June date. But don't worry, Sri - I'll be happy to come to
> Portland too.
>
>
Hah, sounds good!  I would like the lot of you to show.  I will post more
information in a week as I will want to have someone who can help with the
content and what not.

sri


>
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-devel-list

Stackexchange community for GNOME/GTK+

[Sriram Ramkrishna]

I'm creating a stackexchange community for the GNOME platform and the GTK+
toolkit.  I'm looking for help in subscribing to the forum and of course
some people who would be willing to answer questions.  We have three days
to build 5 followers and build about 5-10 questions that can be answered.
After that to get to the next phase, we will need 50 followers and 40 good
questionsI have some folks who are also willing to monitor and answer
questions.

https://area51.stackexchange.com/proposals/109823/gtk-and-gnome?referrer=jPuOAsszR3FdMlqW5m8Y-A2

WHY:  We need to have a search engine index-able library of knowledge on
our platform.  Modern programmers today frequently use stackexchange and
google to ask questions and to look for answers for questions.

Today, questions are answered in mailing lists and irc.  Neither one are
search engine friendly and common questions are often repeated and their
answers not shared.  Let's build a persistent body of knowledge that people
can easily find and lower the bar of entry in writing applications in GNOME
or GTK+.

sri
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-devel-list

Re: Stackexchange community for GNOME/GTK+

[Sriram Ramkrishna]

On Wed, May 10, 2017 at 8:38 AM  wrote:

> On Wed, May 10, 2017 at 7:02 AM Tobias Mueller 
> wrote:
>
>> Hi.
>>
>> On Mi, 2017-05-10 at 08:04 -0500, Michael Catanzaro wrote:
>> > Looks like if you want to do this, we'd have to host it
>> Or use Stackoverflow.
>> Sri's motivation was:
>>
>> > We need to have a search engine index-able library of knowledge on
>> > our platform.  Modern programmers today frequently use stackexchange
>> > and google to ask questions and to look for answers for questions.\
>>
>> I tend to think that Stackoverflow perfectly matches that.
>>
>
> Agreed, I'm a big fan of this but I don't see a reason why it ought to be
> a separate community from the existing Stack Overflow site.
>

At this point the moderator has closed our petition down.  I think this is
unfortunate, and I have mailed the moderator to figure out the rationale
behind the decision.

Stack Overflow is fine if we are just doing programming questions, but I
think we do want other questions on design and maybe asking about features
in GTK+ or GNOME for aspiring application writers.

So for now we are putting this on hold.

sri


> Regards,
> Philip C
> ___
> desktop-devel-list mailing list
> desktop-devel-l...@gnome.org
> https://mail.gnome.org/mailman/listinfo/desktop-devel-list
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-devel-list

Re: Contribution question

[Sriram Ramkrishna]

On Thu, Jan 18, 2018 at 3:30 PM Pavlo Solntsev 
wrote:

> Hi,
>
> To better understand how some glib modules work, I write mini tests. I was
> thinking it would be beneficial for a lot of people if more examples will
> be included into the documentation to better explain how an object can be
> used. Similar to what QT has. I may contribute my examples. When I see
> a code on git hub I think about pull request. Do you use this approach? Or
> I should generate a patch and attach it to the bug report as described here
> https://github.com/GNOME/glib. I saw https://gitlab.gnome.org/ was
> created. Is it a common trend for ? Does glib also go there? Sorry for so
> many questions, just want to understand how dev process works.
>
>

Some of us are working on a documentation portal and we would love
volunteers.  The goal is to create code snippets and what not.  But the
current structure at developer.gnome.org has documentation in various parts
and doesn't have a particular organizing principle (eg someone who
understands how technical documentation is put together) across all
languages.

So if you want to help with creating documetnation we could definitely use
you.

sri

Thanks.
>
>
>
> -Pavlo Solntsev
>
> -
>
> *Please avoid sending me Word or PowerPoint attachments.See
> http://www.gnu.org/philosophy/no-word-attachments.html
> *
> ___
> gtk-devel-list mailing list
> gtk-devel-list@gnome.org
> https://mail.gnome.org/mailman/listinfo/gtk-devel-list
>
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-devel-list

Re: migrating gtk

[Sriram Ramkrishna]

On Tue, Feb 6, 2018 at 8:31 AM Matthias Clasen 
wrote:

> I will ignore the childish name-calling here and just state that as far as
> I am concerned,
> the bugs you file are donations to the project. What we do with them is up
> to us. If we decide
> to fix them, good for you. If not, that's tough and annoying, but lets
> face it: there is an infinite
> number of bug reporters out there, and only a handful of people who spend
> their free time trying
> to keep up with it, so some bugs will always go unfixed, that is just
> reality.
>
>
>
Much as I would hate to extend this conversation beyond what was said; I
felt compelled to comment.  I feel like this is not a very positive message
to send to the overall community.

While brutally true, there is an underlying messaging that encourages a
"why bother?" response from potential contributors.  I am sure that is not
that the intent but messaging is important.

While none of you are PR people and tend to dispense with messaging in lieu
of fortright conversations - I would like to point out that if we want to
increase resources for GTK+ and not be a small group of overworked core
GTK+ people the first step is ensure that we are a community worth
investing time and effort in.

Every contributor who takes an actionable step and reports a bug is a
potential future core contributor.  Please remember that.  A person who
attempts to fix a bug with a patch is even more valuable.

Cheers,
sri
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-devel-list

Re: Development with GObjects

[Sriram Ramkrishna]

On Sat, Aug 18, 2018 at 2:03 PM Philip Chimento via gtk-devel-list <
gtk-devel-list@gnome.org> wrote:

> Nice work, Pavlo! I wonder if you can work this into a patch for the
> GObject documentation :-)
>
> You might want to check out
> https://blogs.gnome.org/desrt/2012/02/26/a-gentle-introduction-to-gobject-construction/
> as well.
>
>
>
Pavlo, if you're interested we are working on a developer documentation
portal.  We might not hit C first, but I'm sure we could use your help when
it comes to organizing and writing tutorials when the time comes.  It's
worth joining up.  Let me know!

sri
___
gtk-devel-list mailing list
gtk-devel-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-devel-list