Citations
Jeremy Bicha
<jeremy at bicha.net>
Thu May 5 01:16:41 EDT 2011
- Previous message: Index of all topics in a set of Mallard pages
- Next message: Citations
- Sort by: [ thread ] [ subject ] [ author ] [ date ]
Hi, I've been helping out the Ubuntu Documentation Team get our version of the Gnome user guide into shape for the 11.04 release. I intend to help Gnome out directly with docs too as time and priorities allow now that 11.04 is basically done. I probably would have posted to this list sooner because j1mc said that he had posted something about citations to the Mallard discussion list but when I checked this list's archives, I didn't see anything posted since December and didn't even bother subscribing to the list. Hopefully, shaun will be able to get the archives working again this week, but it's hard to fix a problem you don't even know about. So I'm going to be "that guy" who jumps into the conversation without any clue about what's been said already. j1mc and I were talking about citing AskUbuntu. While it basically falls under the same license as the Gnome and Ubuntu docs, the site founder requires very specific attribution[1] which I don't think is well suited to the way our user docs work (but that's a different conversation). A bigger issue is that it doesn't look like Mallard has sufficient attribution support. There are two already existing tags that could do this, <comment> and <credit> but credit seems like the better choice to me. I suggest adding a minimum of <link> and <title> to credit and maybe even <p>'s. By the way, I was able to stuff a link in <email> without validation failing so maybe the schema needs to sniff for basic email syntax there. And the other issue is that Yelp doesn't expose any of this info to end users who want to see it, even in the "editor-mode" that is not an editor. I think there needs to be a balance with cluttering the help but I don't believe we're really meeting the basic attribution requirements of CC-BY-SA either. [1] http://blog.stackoverflow.com/2009/06/attribution-required/ Jeremy Bicha -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 900 bytes Desc: OpenPGP digital signature URL: <http://projectmallard.org/pipermail/mallard-list/attachments/20110505/78434f6e/attachment.sig>
- Previous message: Index of all topics in a set of Mallard pages
- Next message: Citations
- Sort by: [ thread ] [ subject ] [ author ] [ date ]
- More information on mallard-list