I think subsections are fine as long as they are small, for long pages, it would be better to have it as subpage.
But TBH I would prefer the subpages everywhere, you can always create some index page that would include the subpages to subsections.
On Thu, Feb 7, 2013 at 2:16 PM, Ryan Lane rlane32@gmail.com wrote:
On Thu, Feb 7, 2013 at 2:29 AM, Petr Bena benapetr@gmail.com wrote:
Everyone knows your phone is more powerful than half of production
cluster,
but now back to the business
We should make a structure for this new documentation base we are going
to
create, I think beside of categories, they might be some spaces at least Documentation: or something like that, where we could put stuff, and it should be divided to:
Wikimedia operation (what is now mostly on wikitech)
- cluster a
-- server 1 -- server 2 etc
- cluster b...
...
I'm in favor of just not importing the server docs. There may be a couple of ops folks this don't agree with me here, though.
Wikimedia labs
- project A
-- instance A-1 -- instance A-2 ...
I'm in favor of heavily refactoring the project pages. They haven't really had much love since they were introduced. Can you give more of an idea of how this would work?
At minimum I'd like to move the projects out of the "Nova_Resource" namespace.
Wikimedia bots
- bot A
-- developer docs (for devs) -- operation docs (for ops) -- user manuals (for end users)
Wikimedia tools
- tool A
-- developer docs (for devs) -- operation docs (for ops) -- user manuals (for end users)
other stuff
this is my proposal, of course it could be done in a different way but we should make a final decision before we start importing stuff or we
create a
mess
Documenting tools and bots this way seems sane to me.
BTW, for all of this, are you describing pages with subsections, or lots of subpages?
- Ryan
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l