[FM Discuss] html manual

[Edward Cherlin]

On Wed, Oct 20, 2010 at 07:03, adam hyde <adam at flossmanuals.net> wrote:
> hi
>
> would anyone like to help me make a manual on HTML?

Sure.

> i was thinking of an outline to support this course:
> http://p2pu.org/webcraft/web-development-101/document/syllabus-web-development-101-0
>
> i started with the docs they already have but i found that actually the
> flow of the material is not very good...you can see the start here:
> http://www.booki.cc/sowc/edit/#
>
> (you need to log into booki first)
>
> for example, there are topics introduced in week 2 that are covered in a
> more basic way than the same topic in week 1. For example week 1 covers
> 'what is html' in a very brief way but gets quite techy while week 2
> starts off with basic info on the structure of an html doc (which is
> already covered in week 1)
>
> i wrote to the course organiser to see if she would like us to help make
> this a book. Looking forward to her answer but I am kind of inclined to
> do it anyways since it would be a good book to have. But to do so I
> think we almost have to start from scratch.

I'm going to take a look at the topics. I suggest an "HTML by Example"
approach, where we start with the simplest possible "Hello, World."
page and then add features just a few at at time. I would encourage
readers to compare the new code with the rendered page each time
before reading our explanations.

Should we explain a Free HTML editor such as Quanta Plus in the process?

I assume that we don't want to get into CSS or JavaScript in this volume.

> I was also thinking it would be good to take this to Barcelona to print
> (nov 3-5) at the drumbeat fest...

Good. I won't have time until after the elections here on Nov. 2.

> anyone keen to lose some days and nights and tag team this until its
> done?
>
> adam
>
>
>
> --
> vote for booki in the Open Web Awards!
>
> Booki (the latest FM project - http://www.booki.cc - a collaborative
> publishing platform) is in the final of the Open Web Awards.
> Great! We are 1 of 3 projects. If we win we get 5000 which we will use
> to do a code sprint on a tropical island somewhere ;)
>
> please please please register :
> http://www.drumbeat.org/user/register
>
> and vote for us:
> http://www.drumbeat.org/project/open-web-publishing
>
> and pass this around!!!! :)
>
> Adam Hyde
> Founder FLOSS Manuals &
> Booki Project Manager
>
> Contact Information
> German mobile : + 49 177 4935122
> Email : adam at flossmanuals.net
> irc : irc.freenode.net #flossmanuals
>
>
> "Free manuals for free software"
> http://www.flossmanuals.net/about
>
> Free Software for making Free Books
> http://www.booki.cc/
>
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>



-- 
Edward Mokurai (默雷/धर्ममेघशब्दगर्ज/دھرممیگھشبدگر ج) Cherlin
Silent Thunder is my name, and Children are my nation.
The Cosmos is my dwelling place, the Truth my destination.
http://www.earthtreasury.org/