Re: doc status report
| From: | Martin Jansen | Date: | Mon, 07 Aug 2006 13:15:04 +0000 |
| Subject: | Re: doc status report | ||
| References: | 1 2 3 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-8265@lists.php.net to get a copy of this message | ||
On Mon Aug 07, 2006 at 01:4743PM +0200, Lukas Smith wrote:
> Martin Jansen wrote:
>
> >On Sun Aug 06, 2006 at 09:0013PM +0200, Lukas Smith wrote:
> >>While working on the MDB2 docs I realized that users have no way of
> >>knowing about the improvements to the documentation of the various
> >>packages unless they are also subscribed to this list. Is there anything
> >>we can do about that?
> >>
> >>Not sure how difficult it would be for example to generate a mail with
> >>all pages that have changed or have been added at the end of the doc
> >>generation and send it off to pear-general.
> >
> >I think the easiest solution would be to maintain a special page in the
> >manual where authors can (manually!) add a short text when they have
> >added a significant improvement to the manual.
>
> Yeah, I starting to think the same. We could then send out a weekly
> "diff" (essentially all added lines) to pear-general.
If we go this route, I suggest we keep this page out of the manual and
stick it in pearweb/. This way we can more easily generate those mails
and even an RSS feed. The manual is slightly "too" static for such
purposes.
- Martin