Re: [Wikitech-l] Define entry point to generate documentation
Le 09/02/2015 18:54, Bryan Davis a écrit : [test entry points] https://www.mediawiki.org/wiki/Continuous_integration/Test_entry_points I hate Makefiles but I'm all for continuing to standardize our job entry points. We do things in too many different ways today. Hello, After a week I have updated the wiki page above and hereby declare 'make docs' is the entry point to generate documentation via Jenkins. Thanks Bryan for your feedback :] -- Antoine hashar Musso ___ Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
[Wikitech-l] Define entry point to generate documentation
Hello, We are migrating Jenkins jobs to simply invokes [test entry points] (ex: composer test, npm test). Some repositories have documentation generated by Jenkins and pushed under https://doc.wikimedia.org/ . I would like to make it as trivial as possible for developers to configure Jenkins, hence I am looking to establish a convention to generate doc. We would need: - a single command we agree on (ex: make doc) - a way to pass/override the destination directory so the jobs in Jenkins can enforce the output where it expects it I have filled https://phabricator.wikimedia.org/T88999 for it. Discussions on wikitech-l preferred. If there is no objections by next week. I will define the convention to be 'make docs' and create all the needed Jenkins jobs templates. Thanks! [test entry points] https://www.mediawiki.org/wiki/Continuous_integration/Test_entry_points -- Antoine hashar Musso ___ Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
Re: [Wikitech-l] Define entry point to generate documentation
On Mon, Feb 9, 2015 at 10:16 AM, Antoine Musso hashar+...@free.fr wrote: Hello, We are migrating Jenkins jobs to simply invokes [test entry points] (ex: composer test, npm test). Some repositories have documentation generated by Jenkins and pushed under https://doc.wikimedia.org/ . I would like to make it as trivial as possible for developers to configure Jenkins, hence I am looking to establish a convention to generate doc. We would need: - a single command we agree on (ex: make doc) - a way to pass/override the destination directory so the jobs in Jenkins can enforce the output where it expects it I have filled https://phabricator.wikimedia.org/T88999 for it. Discussions on wikitech-l preferred. If there is no objections by next week. I will define the convention to be 'make docs' and create all the needed Jenkins jobs templates. Thanks! [test entry points] https://www.mediawiki.org/wiki/Continuous_integration/Test_entry_points I hate Makefiles but I'm all for continuing to standardize our job entry points. We do things in too many different ways today. Bryan -- Bryan Davis Wikimedia Foundationbd...@wikimedia.org [[m:User:BDavis_(WMF)]] Sr Software EngineerBoise, ID USA irc: bd808v:415.839.6885 x6855 ___ Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l