Projects/Restructuring techbase and userbase
< Projects
The story so far:
- part of kde-devel thread starting from dhaumanns mail. http://thread.gmane.org/gmane.comp.kde.devel.general/56132/focus=56136
- IRC discussion:
<dhaumann> steveire: I don't have much time, but maybe we can make
something out of it
<steveire> Hey, so currently there's a projects structure in techbase,
which shows some apps and stuff
<steveire> I think it would make more sense to use
techbase.kde.org/$MODULE or $APP etc. I mentioned it briefly earlier today
elsewhere:
http://thread.gmane.org/gmane.comp.kde.devel.pim/23239/focus=23259
<steveire> Since we don't have much time, I'll just quickly say what I'm
going to propose so you know. Modules and apps get top level urls. I don't
see much need to try to maintain a parent child relationship between pages
because none really exsits. Parents don't have a list of children and
children don't have a link to their parent (although I think that can be
turned on). And I don't think it would be chaos to allow apps and modules
have top level urls.
<dhaumann> steveire: it'll lead to people adding stuff to techbase that
doesn't belong there I fear.
<steveire> Also, we should probably think about what MW features we want
to use and be consistent about it. I mean there's the subpage feature
(which we're already pretty consistent about) and the categories feature
(which I don't think we're very constistent about yet.
<dhaumann> that's why we have the rather strict structure for now.
<steveire> dhaumann: Like what for example?
<dhaumann> steveire: see wiki.kde.org
<dhaumann> that's *the* example.
<dhaumann> steveire: meanwhile, I do think that e.g. a Plasma toplevel
item makes sense
<steveire> I've never really used it, but I'll have a look. What was put
there that doesn't belong?
<dhaumann> it's simply a *mess*
<dhaumann> :)
<steveire> Yes, but also, what is the focus of techbase.kde.org/plasma?
How to start contributing to it? Writing plasmoids? etc?
<dhaumann> on techbase aaron was also pretty much involved. Unfortunately
he's not here right now, but I would like to have his input.
<steveire> OK, well maybe I'll cc him too when I email kde-www about this
stuff.
<dhaumann> in Plasma/* could be all related to plasma. Contributing,
Tutorials, whatever
<dhaumann> steveire: can you CC me as well?
<steveire> Yes, sure
<dhaumann> steveire: did you look at userbase already?
<steveire> What do you mean look at?
<dhaumann> how it is organized.
<steveire> structure wise?
<steveire> Ah, yes, well a bit. I'll look a bit more.
<dhaumann> yes. they e.g. have Applications and Applicatins/Desktop
<dhaumann> but then they link to [[KWin]] etc. so they don't add a 3rd
level but rather link to a new toplevelitem.
<dhaumann> steveire: what I'd still like is to have subpages.
<steveire> Yeah, I see http://userbase.kde.org/Applications/Graphics and
then http://userbase.kde.org/Gwenview, apps get a top level.
<dhaumann> i.e. if we go to add [[$your_app]] then all related content to
this app should be in [[$your_app/*]]
<steveire> dhaumann: Yes. There I agree.
<dhaumann> that's something I'd agree with. Maybe the userbase people can
say something about it?
<steveire> Hopefully. What I'm really looking for is concensus, and
definitely not silence.
<dhaumann> yes :-)
<dhaumann> steveire: let's have a look at
http://techbase.kde.org/index.php?title=Projects
<dhaumann> what we see here are candidates for toplevel items. in fact,
maybe all
<dhaumann> I agree for the apps being toplevel. but for example should KDE
on Mac have a toplevel item as well?
<steveire> http://userbase.kde.org/KJots << This page {{includes}}
http://userbase.kde.org/KJots/Tips and it's also {{included}} in Tutorials.
I think we could do more with that kind of structure.
<dhaumann> steveire: about he {{:...} thing, how does it work exactly?
<steveire> It works the same way as templates, except the leading : makes
it use the top level instead of looking in the Template: namespace.
<steveire> {{Kjots/Tips}} would try to include {{Template:Kjots/Tips}},
but the leading : makes it not do that.
<dhaumann> steveire: is that maintainable?
<dhaumann> thinking about having a page that gets its content from lots of
other pages :)
<dhaumann> also it means duplication in several places. Is that desirable?
<dhaumann> or what are the benefits
<dhaumann> ?
<dhaumann> I can imagine that it would help to have Plasma/Tutorials +
Development/Tutorials and then a plasma section.
<dhaumann> is that it?
<steveire> userbase/tutorials might be one example which would be reduced
to a series of {{:APP/Tips}}. I think it's less duplication.
<dhaumann> what I meant is: you find the same content at different places,
which is duplication. :)
<steveire> Right, yes I suppose, but I think you want that in some cases.
Tutorials would be an index of tips for all apps, but if I go to
http://en.wikipedia.org/wiki/Special:Search?go=Go&search=KJots, there is
still a section of tips on that page too.
<dhaumann> steveire: e.g. if you search for KJots in the search edit
field, you will get the results KJots and KJots/Tips, which will then
display the same.
<steveire> Hehe, I wrote \[\[KJots\]\] there
<dhaumann> mh. not really problem maybe
<steveire> I don't think it's a problem. We can even <noinclude> a link on
the tips page back to the app page.
<dhaumann> I'm still not sure whether all this is a good idea :) but I'm
happy that people show interest
<dhaumann> maybe we can get more feedback on the mailing list, at least
that's what i hope
<steveire> Yes, sure. I just added a noinclude to
http://userbase.kde.org/KJots/Tips.
<steveire> I'll try to put a summary of sorts together and send an email
later or tomorrow.
<steveire> Thanks.
<dhaumann> hm. well, that gives you a message if you are on the page
directly.
<dhaumann> ok, cool.
<steveire> If you're not familiar, <includeonly> is analogous, but in the
other way.
<dhaumann> I know them
<dhaumann> What I meant is it gives you a notice now that there is more in
the KJots page, but no more.
<dhaumann> so it has no other effect wrt maintainability or structure.
<dhaumann> nevermind.
<dhaumann> have to leave :)
<dhaumann> I'm looking forward to find a good solution :)
<steveire> We could <includeonly>[[Category:Tips pages]]</includeonly> and
the tips pages would be in that category, but not the pages that
{{:include}} them
<steveire> Cool, later.
<annew> steveire: I've just come in and read this
<annew> I was wondering how the include works, so that's helped me, thanks
<steveire> annew: Hi, sure no problem.
<annew> steveire: I think we should try for consistency between userbase
and techbase
<annew> so could you keep me informed of discussions and decisions?
<steveire> Also regarging the kjots icon being too big, I think it should
only be shown once anyway, and not used as a list item as it is now
<steveire> annew: Are you on kde-www?
<annew> no - do you think I should be?
<annew> perhaps it makes sense
<steveire> I'd like to see it as a place to discuss *base.kde.org.
<steveire> I think it makes sense.
<annew> ok - I'll subscribe tonight
<steveire> jucato was involved in setting up userbase too wasn't he?
<steveire> Hmm, looks like userbase only allows openid, and not 'normal'
registration.
<annew> yes - danimo insisted on that
<annew> it makes creating a test account non-trivial