[Yesod] Yesod book repo?

Hi All,

Is http://github.com/snoyberg/yesoddocs/ still the official repo for
the book or should it be http://github.com/yesodweb/yesoddocs/?

Where is the actual book content? The repo seems to be all logic. The
only trace of content I see is in the book-xml branch from Nov 2010.

Thanks,
Bjorn

Re: [Yesod] What makes Yesod special?

I gotta say that the automated database migration in persistent
knocked my socks off after I was working on a django project (this was
before they had any sort of official migration support).

Now I just update my models as much as I want during development and
BAM! it either does everything automatically or tells me what to do.

On Thu, Sep 1, 2011 at 4:12 AM, Arash Rouhani <miffoljud@...> wrote:
> I think this is a great idea, and I would really like to be able to
> contribute. However, as I've never written any html (only hamlet :)) in my
> life, I can't compare Yesod to anything. I can however maybe write a little
> about how a non-web developer can get a good start in the right direction
> using Yesod. Would such a story be of interest as-well?
>
> Oh, I would love to hear from other people about the comparisons. I need
> some good pro-yesod arguments, so I can win the daily
> yesod-vs-rails-discussions in school!
>
>
> Cheers,
>
> Arash Rouhani
>
>
> On 08/31/2011 06:37 PM, Michael Snoyman wrote:
>>
>> Hi all,
>>
>> Here's a bit of a turn of events: I want you guys to market Yesod to
>> me. Said another way: what are the features you get from Yesod that

Re: [Yesod] Where does this message come from?

Re: [Yesod] Yesod book repo?

snoyberg/yesoddocs is what actually gets used in practice. Greg
created the yesodweb/yesoddocs and does his hacking on it.

The actual book content is all stored in the database as DITA. Little
known secret: you can download it all here:
http://www.yesodweb.com/show/map/1/download

As for how to turn that into something meaningful... DITA is an open
standard, similar to say DocBook. The industry I work in uses it a
lot, and for processing it uses something called the DITA-OT. The
DITA-OT is one of the most poorly written pieces of software I've ever
had the misfortune of using. I'm in the process of writing some
alternate processing code in Haskell. When that's ready, you could in
theory use that to convert the book into another format.

Michael

On Thu, Sep 1, 2011 at 3:04 AM, Bjorn Buckwalter
<bjorn.buckwalter@...> wrote:
> Hi All,
>
> Is http://github.com/snoyberg/yesoddocs/ still the official repo for
> the book or should it be http://github.com/yesodweb/yesoddocs/?
>
> Where is the actual book content? The repo seems to be all logic. The
> only trace of content I see is in the book-xml branch from Nov 2010.
>
> Thanks,
> Bjorn

Re: [Yesod] Where does this message come from?

That's correct, it's automatically added by Chrome. Last time I
checked, Firefox didn't have that message, though things have likely
changed by now. I think I tested it on Firefox 4, and they're up to
like 639 now, right?

On Thu, Sep 1, 2011 at 3:35 AM, Greg Weber <greg@...> wrote:
> is that an html5 validation? (which would be added automatically to a
> required field)
>
> On Wed, Aug 31, 2011 at 2:19 PM, Paul Brauner <polux2001@...> wrote:
>>
>> I wanted to add some javascrip validation to my forms so I decided to look
>> at the code that generate the "Please fill out this field" popup message for
>> dayField. Except there is none! At least I didn't fine "Please" by greping
>> the code of yesod-form. Is it imported with jquery?
>> Paul
>

Re: [Yesod] Where does this message come from?

Re: [Yesod] Where does this message come from?

[Yesod] Re: Yesod book repo?

OK, It seems submitting book content patches/pull requests is a thing
of the past then(?).

Some comments then regarding http://www.yesodweb.com/book

1. It would be nice if this page also accepted comments like the
others in the book, but since it is not I'm sending my comments here.

2. "If you have any suggestions, you can email me or simply send
patches to the Yesod documentation site github repo." Maybe it could
be clarified that the repo is only for infrastructure and not content?
(And perhaps readers of the first page are unlikely to submit
infrastructure changes anyway?) You could also mention the paragraph
commenting system here.

3. "All syntax-highlighted code snippets are automatically tested
against the most recent Yesod release (0.8.0) to ensure they are
correct." – 0.8.0 is not the most recent release any more. Is the
automated testing against 0.8 or 0.9 now, or not at all?

Thanks,
Bjorn

On Sep 1, 10:46 am, Michael Snoyman <mich...@...> wrote:
> snoyberg/yesoddocs is what actually gets used in practice. Greg
> created the yesodweb/yesoddocs and does his hacking on it.
>
> The actual book content is all stored in the database as DITA. Little
> known secret: you can download it all here:http://www.yesodweb.com/show/map/1/download
>
> As for how to turn that into something meaningful... DITA is an open
> standard, similar to say DocBook. The industry I work in uses it a
> lot, and for processing it uses something called the DITA-OT. The
> DITA-OT is one of the most poorly written pieces of software I've ever
> had the misfortune of using. I'm in the process of writing some
> alternate processing code in Haskell. When that's ready, you could in
> theory use that to convert the book into another format.
>
> Michael
>
> On Thu, Sep 1, 2011 at 3:04 AM, Bjorn Buckwalter
>
>
>
>
>
>
>
> <bjorn.buckwal...@...> wrote:
> > Hi All,
>
> > Ishttp://github.com/snoyberg/yesoddocs/still the official repo for
> > the book or should it behttp://github.com/yesodweb/yesoddocs/?
>
> > Where is the actual book content? The repo seems to be all logic. The
> > only trace of content I see is in the book-xml branch from Nov 2010.
>
> > Thanks,
> > Bjorn

Re: [Yesod] Re: Yesod book repo?

I've updated the text, I think it was too long before. A lot of the
caveats about not being ready can be removed, and users don't need to
know that I check the syntax highlighted code, it should be a safe
assumption that the code snippets are accurate.

On Thu, Sep 1, 2011 at 9:38 AM, Bjorn Buckwalter
<bjorn.buckwalter@...> wrote:
> OK, It seems submitting book content patches/pull requests is a thing
> of the past then(?).
>
> Some comments then regarding http://www.yesodweb.com/book
>
> 1. It would be nice if this page also accepted comments like the
> others in the book, but since it is not I'm sending my comments here.
>
> 2. "If you have any suggestions, you can email me or simply send
> patches to the Yesod documentation site github repo." Maybe it could
> be clarified that the repo is only for infrastructure and not content?
> (And perhaps readers of the first page are unlikely to submit
> infrastructure changes anyway?) You could also mention the paragraph
> commenting system here.
>
> 3. "All syntax-highlighted code snippets are automatically tested
> against the most recent Yesod release (0.8.0) to ensure they are
> correct." – 0.8.0 is not the most recent release any more. Is the
> automated testing against 0.8 or 0.9 now, or not at all?
>
> Thanks,
> Bjorn
>
>
> On Sep 1, 10:46 am, Michael Snoyman <mich...@...> wrote:
>> snoyberg/yesoddocs is what actually gets used in practice. Greg
>> created the yesodweb/yesoddocs and does his hacking on it.
>>
>> The actual book content is all stored in the database as DITA. Little
>> known secret: you can download it all here:http://www.yesodweb.com/show/map/1/download
>>
>> As for how to turn that into something meaningful... DITA is an open
>> standard, similar to say DocBook. The industry I work in uses it a
>> lot, and for processing it uses something called the DITA-OT. The
>> DITA-OT is one of the most poorly written pieces of software I've ever
>> had the misfortune of using. I'm in the process of writing some
>> alternate processing code in Haskell. When that's ready, you could in
>> theory use that to convert the book into another format.
>>
>> Michael
>>
>> On Thu, Sep 1, 2011 at 3:04 AM, Bjorn Buckwalter
>>
>>
>>
>>
>>
>>
>>
>> <bjorn.buckwal...@...> wrote:
>> > Hi All,
>>
>> > Ishttp://github.com/snoyberg/yesoddocs/still the official repo for
>> > the book or should it behttp://github.com/yesodweb/yesoddocs/?
>>
>> > Where is the actual book content? The repo seems to be all logic. The
>> > only trace of content I see is in the book-xml branch from Nov 2010.
>>
>> > Thanks,
>> > Bjorn

[Yesod] Migration to 0.9 guide