Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Branch: master
Fetching contributors…

Cannot retrieve contributors at this time

34 lines (27 sloc) 0.882 kB

Formerly

---

I thought it might be helpful to come up with a coherent design for POE documentation, get some feedback, and then start rewriting (as well as sending armed gorillas after anyone who writes module docs which don't stick to the design.)

Some of this has already been discussed a level up, but rather than totally refactor that I want to focus on design and then refactor both.

Design goals

  • /Accuracy
  • Clarity
  • Terseness
  • Forward reference reduction
  • Sane linkage
  • Simple multi-formatting

Documentation types

  • Intro/tutorial
  • Overview
  • Cookbook
  • Reference
  • Module
What I want is general spec covering the goals for each type (i.e. thirty short, concise wiki pages, plus a few introductory pages like this one. I am just going to bull ahead with this, and (eventually) hit the mailing list(s) to try to get people in here to comment.

Jump to Line
Something went wrong with that request. Please try again.