canmove, Confirmed users
1,953
edits
User:Ckoehler/About wiki.mozilla.org: Difference between revisions
→Comments: #About_Developer_documentation
(→Comments: #About_Developer_documentation) |
|||
| Line 86: | Line 86: | ||
: Good question. Both of the pages you link to seem fine for the Mozilla Wiki. Web Compatibility is a Mozilla project and those pages document how to contribute to it. As I'm responding to this, I'm realizing that the section distinguishing what content belongs on MDN and what belongs on Mozilla Wiki needs further work. Do others have a good way to describe the delineation between the technical information that should go on MDN vs Mozilla Wiki? [[User:Ckoehler|Christie Koehler (ckoehler)]] ([[User talk:Ckoehler|talk]]) 16:52, 9 May 2014 (PDT) | : Good question. Both of the pages you link to seem fine for the Mozilla Wiki. Web Compatibility is a Mozilla project and those pages document how to contribute to it. As I'm responding to this, I'm realizing that the section distinguishing what content belongs on MDN and what belongs on Mozilla Wiki needs further work. Do others have a good way to describe the delineation between the technical information that should go on MDN vs Mozilla Wiki? [[User:Ckoehler|Christie Koehler (ckoehler)]] ([[User talk:Ckoehler|talk]]) 16:52, 9 May 2014 (PDT) | ||
: Developer documentation can be confusing to think about because it's both produced and consumed by developers. In short, product documentation goes on MDN; process documentation goes on the wiki. In open source, the source code is part of the product, so so things like building and debugging instructions are product documentation. Process documentation includes things like product plans and roadmaps, team meeting notes, bugzilla workflows, etc. Another way to think about it: MDN documents how to interact with code; the wiki documents how to interact with teams. For Karl's examples, I'd say that the Guide is a process doc (people interaction) and the Updating doc is a product doc (code interaction) that would go under the Mozilla Build section on MDN. [[User:Jswisher|Jswisher]] ([[User talk:Jswisher|talk]]) 10:23, 14 May 2014 (PDT) | |||
'''About WikiMo''': The about page says currently "Governance issues are managed by the WikiMo module, a sub-module of Websites." but it doesn't explain what is WikiMo and the link goes to a table which is not really about Governance. Is there a more appropriate place on the wiki or elsewhere? [[User:Karlcow|Karlcow]] ([[User talk:Karlcow|talk]]) 15:46, 9 May 2014 (PDT) | '''About WikiMo''': The about page says currently "Governance issues are managed by the WikiMo module, a sub-module of Websites." but it doesn't explain what is WikiMo and the link goes to a table which is not really about Governance. Is there a more appropriate place on the wiki or elsewhere? [[User:Karlcow|Karlcow]] ([[User talk:Karlcow|talk]]) 15:46, 9 May 2014 (PDT) | ||