[Slackdocs] Slackbook Conventions and article updates

[Matthew Fillpot]

On Tue, Sep 4, 2012 at 11:17 PM, Rodrigo Amorim Ferreira <
rodrigo at codecommunity.org> wrote:

> On Tue, 2012-09-04 at 21:24 -0400, Matthew Fillpot wrote:
> > All,
> > I am in the process of updating all slackbook pages to match the
> > original and have come across an issue that needs input.
> >
> >
> > I know that our goal is to keep a clone of the slackbook-beta, however
> > the installation page(http://docs.slackware.com/slackbook:install) on
> > the wiki has been greatly changed and I need guidance. Should I remove
> > all new content and restore the original, restore the original and
> > keep the external links or take another path to guarantee that the
> > community revisions are not lost?
> >
> >
> > I am working one chapter at a time, once this has been decided I will
> > continue to work through the book.
> >
> >
> > --
> > -Thank You,
> > -Matthew Fillpot
> >
> >
> > -Slackware Documentation Project - Staff Editor
> > - http://docs.slackware.com/wiki:user:mfillpot
> >
> >
> > -Linux.com - Moderator
> > - https://www.linux.com/forums/person/198
> >
> >
> > _______________________________________________
> > Slackdocs mailing list
> > Slackdocs at alienbase.nl
> > http://lists.alienbase.nl/mailman/listinfo/slackdocs
>
> Hi Matthew,
>
> I think you can try three different paths:
>
>
> FIRST PATH
>
> I would suggest evaluate both pages (from Beta and SlackDocs) and create
> a new install page with the best parts of this two origins [more work to
> do].
>
>
> SECOND PATH
>
> Try to improve the SlackDocs install page with some ideas in the Beta
> install page (if exists) [less work to do].
>
>
> THIRD PATH
>
> Do nothing and let the SlackDocs install page be improved naturally by
> the community [you only point to the Beta version and let the community
> do the hard work].
>
> Best Regards.
>
> Rodrigo
>
> NOTE: And I don't know about the possible impact this modifications
> would do to other (already-started) translation projects. I can only
> talk about my part of the translation (Brazilian portuguese, or pt-br
> for short).
>
> In the Brazilian portuguese translation of the SlackDocs Slackware Linux
> install page, I modified it so much that it doesn't resembles anymore
> the original one (the actual SlackDocs Slackware Linux install page in
> English). And in case you choose some big modification in the actual
> install page, I will only try to catch the new parts (if exists) that
> will be good to absorb in my own version (I already expanded it a lot),
> and try to improve a bit more for the Community's sake :D
>
> But I will encourage any modifications in the English install page that
> can make it better for the whole Project :)
>
>
Rodrigo,
Thank you for your insight, it helped me come to a decision.

Here is what I want to do:
Per our discussions the slackbook pages will be clones of the original
documents, so I plan to copy the current page back to the slackware:install
namespace for community additions and rebuild the slackbook:install to the
original state. This will cleanly separate the two documents.

We must remember that unlike in a wiki, the true slackbook has page and
space requirements. Components of the slackware:install page may
potentially be merged into the slackbook if Alan finds content of interest
or the contributor submits a patch to Alan.

As for the pt-br page, the site guidelines state that all revisions must be
posted in english  first, so your improvements should also be made to the
english copy of the document when it has been moved.

Are there any objections to this plan of action?

-- 
-Thank You,
-Matthew Fillpot

-Slackware Documentation Project - Staff Editor
- http://docs.slackware.com/wiki:user:mfillpot

-Linux.com - Moderator
- https://www.linux.com/forums/person/198
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.alienbase.nl/pipermail/slackdocs/attachments/20120905/db43c0e0/attachment.html>