Mercurial Definitive guide is out of date. Plus obvious solution.

[Na'Tosha Bard]

As a follow-up, I've just had a quick chat with Henrik on IRC and he should
be setting up a server for us to build the book on (e.g, generate the pdf)
hopefully soon-ish.  I'll keep poking him :-)  He would prefer not to use a
Wiki, but the book will not be hard to update in any case, it's just a
Mercurial clone with (I think) html source.

I'll try to keep the list updated with progress (as well as the wiki page
about the subject).

Cheers,
Na'Tosha

On Tue, Jul 5, 2011 at 4:38 PM, Na'Tosha Bard <natosha at unity3d.com> wrote:

> On Tue, Jul 5, 2011 at 3:58 PM, Neutrino <redirect.null at gmail.com> wrote:
>
>> Sounds good. Rather than worrying about what the 'new book' should
>> contain,
>> let's just migrate the existing content to a Wiki first and then improve
>> it
>> in an evolutionary manner.
>>
>
> The plan actually is to move the book (in the format it is in now) to a
> server we control that can build it, rather than move it to a wiki.  We are
> also hoping to get O'Reilly to publish a second version of the book.
>
> So far we haven't figured out where the server for the book is coming from,
> but I will follow up on it.
>
>
>> Then at that point decide whether a major rewrite is necessary. Once
>> casual
>> users have the ability to edit it there is a chance that the existing
>> content will come into sync by itself perhaps precluding the need for a
>> coordinated major rewrite.
>>
>
> It's already decided (as far as I know) that a major rewrite is necessary
> -- since we are also hoping to have O'Reilly publish a second revision of
> the book, it needs to be reviewed, edited, etc, in a much more thorough
> manner than just letting community users update it.
>
>
>> There's only a dozen or so pages. So that would require copying each page
>> across and then reformatting it for Wiki sysntax. Does your existing Wiki
>> have a Discussion feature for each page like MediaWiki does? I couldn't
>> see
>> it. If it does we could also migrate over the comments and implement the
>> best ones.
>>
>> I also liked the embedded article comments in the existing online
>> Definitive
>> Guide. MediaWiki has an ArticleComments extension that perhaps does
>> something similar. I believe MediaWiki also has the ability to download
>> the
>> entire thing as a pdf, which would be nice as you don't need to maintain
>> Wiki and pdf versions separately.
>>
>> I don't work for MediaWiki or anything, just used it before and been
>> rather
>> impressed :)
>>
>> If we decide to do it I'll volunteer to migrate a page or two.
>>
>
> I would like to see Henrik's input on this (although I think he is on
> vacation right now) -- he did the work of seeing what it would take to set
> up buiding the book (and I don't think it was easy); I'd like to know if
> he'd prefer to keep with this format or move to something else.  Let's wait
> for him to reply before we jump to any conclusions.  The fact that we want
> to send the book back to the publisher may have some say in what format it
> needs to be in, as well.
>
> Cheers,
> Na'Tosha
>
>
> --
> *Na'Tosha Bard*
> Build & Infrastructure Developer | Unity Technologies
>
> *E-Mail:* natosha at unity3d.com
> *Skype:* natosha.bard
>
>


-- 
*Na'Tosha Bard*
Build & Infrastructure Developer | Unity Technologies

*E-Mail:* natosha at unity3d.com
*Skype:* natosha.bard
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mercurial-scm.org/pipermail/mercurial/attachments/20110705/98fed576/attachment.html>