On 08/17/2016 04:00 PM, Ken Gaillot wrote: > On 08/17/2016 12:34 AM, Digimer wrote: >> On 16/08/16 02:09 PM, Ken Gaillot wrote: >>> Hello everybody, >>> >>> Our Pacemaker developer documentation has been scattered across the >>> ClusterLabs website, wiki, and repository. Since we've been seeing more >>> activity from new contributors, I've made a first step to consolidating >>> that into a new "Pacemaker Development" document, to make it easier for >>> new developers to find everything they need to know. >>> >>> "Pacemaker Development" is linked in the usual place >>> (http://clusterlabs.org/doc/). >>> >>> Currently, it just replaces the repository's coding-guidelines.txt and >>> some developer FAQs on the website and wiki. Over time, we can >>> consolidate anything of interest to developers working on the Pacemaker >>> codebase. >>> >>> Feel free to recommend or submit pull requests for changes. The source >>> is in the pacemaker repository under "doc", along with the existing >>> documents such as "Clusters From Scratch". >> This is fantastic! >> >> There is a bunch of badly out dated documentation over at the >> fedorahosted.org trac wiki. For example, the FenceAgentAPI doesn't cover >> meta-data (https://fedorahosted.org/cluster/wiki/FenceAgentAPI). >> >> I wonder how many people start (or might start) their contributions via >> custom RA and FAs? Maybe having similar documents, if not directly in >> your new document, would be helpful (your call, I don't know if sections >> of FA/RAs would deserve their own guide)? >> >> Anyway, I am very stoked about this! :D > Definitely we have some dated material floating around :) > > Updated RA/FA developer documentation is a good idea, but the new > document is specifically for working on code shipped with the pacemaker > package. That could be a new document in the resource-agents and/or > fence-agents packages. or maybe the clusterlabs wiki, or perhaps > if/after OCF gets taken under the clusterlabs umbrella, we could put it > in the OCF repo. On the other hand describing how to write a RA/FA could be seen as some kind of description of an interface pacemaker provides ... > > _______________________________________________ > Developers mailing list > [email protected] > http://clusterlabs.org/mailman/listinfo/developers
_______________________________________________ Developers mailing list [email protected] http://clusterlabs.org/mailman/listinfo/developers
