[haiku-doc] Re: Installation docs with css and javascript

Philippe Michael Groarke wrote:

Hello everybody (Humdinger), I've finally finished my installation docs :) 
Hurray!


Congrats. Very nice for the first shot. :)


Well, that's for the relief. Anyway, here included is a zipped file of my 
documents.
I'm looking over it, insert some small formatting stuff etc. and will later check it in to be further worked on. 


I've included the edits to the css I talked about earlier. I also use a small 
script,
which loads pages in a new window/tab since xhtml strict doesn't allow 
rel="_blank".
This could be used by anybody who needs to link to external websites (just add
rel="external" to your <a href...> statements).
Well... I don't think it's needed. Personally, I hate when websites shove link behaviour down my throat. IMO a link should always simply take me to the linked site. If I want to open it in another window/tab, I middle-click or use a modifier key or the context menu or however I configured my browser. 
So, I'd vote against inconsistent link behaviour.


So, on another note, when will we see the UserGuide on the Haiku website :D
Good question. I don't feel like prodding again on the web mailing list... And it looks like the wiki-like test site that could also help with translations is still some time away. Let's give it a bit more time. 


This has
become fairly important, since some of the writers from which I used help 
guides could
edit the UserGuide directly, and remove their old documents from the site. More
visibility and more editing the guide... great!
BTW, we should at least put the original authors in the author comment of each respective page.
Are you interested to further improve the installation section? (Of course, wait first until I checked the current version in.) I think it would be good to have the installation.html as a sort of "contents" page for the different installation methods. So, after the current small introduction <h1> headers with another short intro to the topic and a link to the actual page. 
That way, we could also avoid duplication of e.g. GRUB configuration.
If you want to, I can make a quick stubbed version that will illustrate what 
mean.

In any case, nice work! Thanks, and also thanks to all the original authors!

Regards,
Humdinger

--
--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-
Deutsche Haiku News @ http://www.haiku-gazette.de

Other related posts: