#26272: Add documentation on how to build a homepage/table of contents
-------------------------------------+-------------------------------------
Reporter: MalikRumi | Owner: nobody
Type: New feature | Status: closed
Component: Documentation | Version: 1.9
Severity: Normal | Resolution: needsinfo
Keywords: Home page, Table of | Triage Stage:
Contents | Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by timgraham):
* status: new => closed
* needs_better_patch: => 0
* needs_tests: => 0
* needs_docs: => 0
* resolution: => needsinfo
Old description:
> 1. Building a home page
> I posted this to Django Groups, and while responding to Bob I realized
> this might need to be a feature request, so I'm here making it. Here's
> the link: https://mail.google.com/mail/u/0/#inbox/1530e36e323dadbf
>
> 2. Building a Table of Contents
> This is another area where getting solid information is hard to come by.
> I am NOT talking about using Sphinx or anything like that. This is not
> for documentation, it is for a Table of Contents for end users of the
> site. Such tables are typically hierarchical, which requires either a 3rd
> party app or a judicious use of parent child relationships. And while we
> can use ListView as a starting point, what about features that spread
> across different apps, or don't have strictly hierarchical relation but
> that you still want to list together somehow?
>
> I am perfectly willing to work on this, (I have lots of non-technical
> writing experience) even alone, so long as I had the ear of Django
> experts who would respond to issues I run into or questions I have about
> how it should all work, best practices, etc.
New description:
1. Building a home page
I posted this to [django-users https://groups.google.com/d/topic/django-
users/EMtRahO3EYI/discussion], and while responding to Bob I realized this
might need to be a feature request, so I'm here making it. Here's the
link:
2. Building a Table of Contents
This is another area where getting solid information is hard to come by. I
am NOT talking about using Sphinx or anything like that. This is not for
documentation, it is for a Table of Contents for end users of the site.
Such tables are typically hierarchical, which requires either a 3rd party
app or a judicious use of parent child relationships. And while we can use
ListView as a starting point, what about features that spread across
different apps, or don't have strictly hierarchical relation but that you
still want to list together somehow?
I am perfectly willing to work on this, (I have lots of non-technical
writing experience) even alone, so long as I had the ear of Django experts
who would respond to issues I run into or questions I have about how it
should all work, best practices, etc.
--
Comment:
I don't see where this would fit into the docs. I think it's really too
broad a topic to give general guidance without making specific
recommendations that are usually project specific. If you want to try to
write something, but all means, feel free to propose it but until we see
the details, I don't think there's much value in keeping a ticket like
this open. Hope not to discourage you!
--
Ticket URL: <https://code.djangoproject.com/ticket/26272#comment:1>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/067.a6b2ef13684532d7ee3d54df482a95d0%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
