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(a)gmail.com> wrote:
On Thu, Feb 7, 2013 at 2:29 AM, Petr Bena
<benapetr(a)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(a)lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l