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 <[email protected]> wrote: > On Thu, Feb 7, 2013 at 2:29 AM, Petr Bena <[email protected]> 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 > [email protected] > https://lists.wikimedia.org/mailman/listinfo/wikitech-l > _______________________________________________ Wikitech-l mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/wikitech-l
