[Mailman-Developers] Website re-org?
adam-mailman at amyl.org.uk
Sat Dec 5 13:21:09 EST 2015
On Sat, Dec 05, 2015 at 01:10:10AM -0800, Terri Oda wrote:
> 3. Find out how to report a bug
> We kind of fail on this one, except if you want to report a security
> issue. Again, this is more complex than it might seem since there's
> a bunch of different components.
Would it be easier here, to list the components, and then maybe link
to the docs, and roadmap/issue tracker?
something better presented than:
| mailman 2 | stable version | docs | bug tracker | mm-users |
| mailman bundler | everything | docs | bug tracker | mm-devs |
| posterious |
| hyperkitty |
or maybe a page linking to each item? Something like
https://www.mysociety.org/projects/components/ (usual disclosure: I'm
a co-founder of mySociety).
> 4. Find the docs / get help with an issue.
> The good: they're linked right there in the top bar. The bad: is
> someone looking at this going to know they want the docs for
> postorius vs hyperkitty? Will any of that make sense? I think we
> might need a landing page here.
Maybe clarified in the above layout suggestion?
> * Get Mailman
> - Links to source code and install guides, high level description of
> what to do.
Possibly also things like packages.debian.org/mailman etc; homebrew; I
would expect that most people will install with their package manager,
despite what 'we' might prefer.
> * Help and Documentation
> - landing page with a link to the docs, wiki and mailing lists, with
> instructions. Maybe some search boxes? Userguides go here too.
> * Report an issue / Contact Us
> - landing page with reminder about reporting security bugs, links to
> bug trackers, mailing lists, irc
Link to the hot topics (dmarc, install, what ever's currently getting
the most hits in a given period)?
> * How to Contribute
> - new contributors guide here, prefaced by the basic source/gitlab links
Avoid duplication here, maybe, and just link to the Sphinx/RTD pages?
Fairly sure I've seen a CONTRIBUTE file, somewhere. Maybe also link to
coding standards (I think these are unified for the various
> Thoughts on better ways to set this up? Other suggestions of things
> people often want out of our website?
Do ordinary folk want to find "where can i get one of these set-up for
me" -- the vendors/hosting list, perhaps -- although maybe with some
sort of ratings thing (and a last updated / which versions).
"You can't say that, because it's true."
(unnamed Russian censor, to Malcom Muggeridge, 1933)
More information about the Mailman-Developers