Re: [Inkscape-docs] Extensions guide

2017-11-07 Thread Maren Hachmann
Hey Mois, great - I'm looking forward to your involvement and hope you'll enjoy being a contributor to Inkscape :) Maren Am 07.11.2017 um 14:50 schrieb Mois: > Thanks for the info! > > I'm glad there are code reviews :) > I hope to be able to contribute. > > Mois > > On 11/07/2017 03:27 PM, M

Re: [Inkscape-docs] Extensions guide

2017-11-07 Thread Mois
Thanks for the info! I'm glad there are code reviews :) I hope to be able to contribute. Mois On 11/07/2017 03:27 PM, Maren Hachmann wrote: > Clarification: Inkscape is on gitlab.com: > https://gitlab.com/inkscape/inkscape > > Am 07.11.2017 um 14:24 schrieb Maren Hachmann: >> Just create an acco

Re: [Inkscape-docs] Extensions guide

2017-11-07 Thread Maren Hachmann
Clarification: Inkscape is on gitlab.com: https://gitlab.com/inkscape/inkscape Am 07.11.2017 um 14:24 schrieb Maren Hachmann: > Just create an account :-) Then learn about the gitlab workflow. > > New developers are required to make merge requests for their first > couple of contributions to Inks

Re: [Inkscape-docs] Extensions guide

2017-11-07 Thread Maren Hachmann
Just create an account :-) Then learn about the gitlab workflow. New developers are required to make merge requests for their first couple of contributions to Inkscape, and even seasoned devs, who already have access to the repository's master and other official branches, very often ask for feedba

Re: [Inkscape-docs] Extensions guide

2017-11-07 Thread Mois
> So if you would like to generate it via CI and make the result available Cool, where do I sign? Where do I get creds for gitlab? Mois -- Check out the vibrant tech community on one of the world's most engaging tech site

Re: [Inkscape-docs] Extensions guide

2017-11-07 Thread Maren Hachmann
Am 07.11.2017 um 12:15 schrieb Mois: >> One question is if we want to document Inkscape source and Python >> extension API in the same document > Not sure what you mean by this, but I suppose it's better if they're > separate. Doesn't Doxygen generate one page per > class/module/interface/whatever?

Re: [Inkscape-docs] Extensions guide

2017-11-07 Thread Mois
> One question is if we want to document Inkscape source and Python > extension API in the same document Not sure what you mean by this, but I suppose it's better if they're separate. Doesn't Doxygen generate one page per class/module/interface/whatever? So they would both be automatically linked f

Re: [Inkscape-docs] Extensions guide

2017-11-07 Thread Eduard Braun
Am 07.11.2017 um 01:08 schrieb Maren Hachmann: @Eduard: Do you know if there is anything that needs to be taken into account, before someone makes a new git branch and starts to work on adding comments and adjusting doxygen settings (or other things)? None that I'm aware of... The "Doxyfile" i

Re: [Inkscape-docs] Extensions guide

2017-11-06 Thread Maren Hachmann
I'm not sure about the current maintenance status of Doxygen in the project, but more and up-to-date, automated api documentation sounds great to me! It would probably be possible to integrate any generated static html pages into the Inkscape website, along with the other docs (tutorials, man page

Re: [Inkscape-docs] Extensions guide

2017-11-06 Thread matyilona
Hi, for now I've extended the Python modules for extensions, and linked to it from a few pages to make it easier to find, but I'd be interested in documenting the api too. As for the generator Doxygen might be an option. I haven't used it extensively, but it supports python (with traditional docs

Re: [Inkscape-docs] Extensions guide

2017-10-30 Thread Mois
Hi, I am not sure if that is what you meant, but some proper api documentation would be wonderful! By this I mean commenting the code and then generating documentation from the comments, e.g. using Epydoc or Sphinx . Indeed the

Re: [Inkscape-docs] Extensions guide

2017-10-29 Thread Maren Hachmann
Yes, of course that's okay :) You should have received an email with a random password for your first login. Regards, Maren Am 29.10.2017 um 18:56 schrieb matyil...@openmailbox.org: > Hi, > > if it's ok, I'd like this email (matyil...@openmailbox.org) with the > username matyilona. > > Thanks

Re: [Inkscape-docs] Extensions guide

2017-10-29 Thread matyilona
Hi, if it's ok, I'd like this email (matyil...@openmailbox.org) with the username matyilona. Thanks, matyilona On Sun, Oct 29, 2017 at 06:40:02PM +0100, Maren Hachmann wrote: > Hi matyilona, > > some documentation for those main modules would be helpful, indeed. > > If you let us know your des

Re: [Inkscape-docs] Extensions guide

2017-10-29 Thread Maren Hachmann
Hi matyilona, some documentation for those main modules would be helpful, indeed. If you let us know your desired user name / email address for the Wiki, we can provide you with access, so you can start right away, while the info is still fresh in your mind :) Regards, Maren Am 29.10.2017 um 1

Re: [Inkscape-docs] Extensions guide

2017-10-29 Thread brynn
Welcome matyilona! Have you already seen what we have so far, on the website? https://inkscape.org/en/develop/extensions/ Since writing extensions is mostly over my head, I can't judge which contents are complete or which need more "flesh". But others will chime in soon. I just wanted to s