Added initial text for "views" page.

dlochrie commented 11 years ago

Change whatever you think needs some changing, especially around the text for "partials" and "best practices". I left out a guide for what markup looks like with ejs and jade, since there are a lot of resources for that out there.

Also, from previous experience in the Rails world, I have always referred to includes as partials, and I'm still confused as to what we should call them in Node....

1602 commented 11 years ago

Thanks Daniel! I'm sorry for long answer, I'm really busy in ~~real life~~offline these days. Couple notes about formatting:

try to avoid deeply nested headings, because code becomes less readable when h3,h4,h6 used without h1 and h2. i suggest to use h1 once, then h2 per each section and h3,h4 inside sections for sub-sections and paragraphs.
please use four spaces indent in examples to be consistent (we are using four spaces everywhere).

Re: partials. A while ago partial keyword were removed from express and templating engines, replaced with includes, which works as precompiled templates, so, no dynamic includes allowed anymore, only static filenames.

Thanks for your contribution. Do not hesistate to mention you as author in guides you writing, and editor where you just edited text, of co-author where you added something useful. I think ## Authors section in the bottom of guide makes sense.

Cheers

PS: I will add my 5 cents to this guides when I get chance.

dlochrie commented 11 years ago

Thanks for the tips, I will try to keep to those conventions when I'm adding text.

Concerning the ##Authors section, do you mean we should add them on each page, or just to the bottom of the https://github.com/compoundjs/guides README?

anatoliychakkaev commented 11 years ago

I think it makes sense to add this section on particular pages. Later we can summarize everything on main page of course.

On Mon, Apr 22, 2013 at 6:09 PM, Daniel Lochrie notifications@github.com wrote:

Thanks for the tips, I will try to keep to those conventions when I'm adding text.

Concerning the ##Authors section, do you mean we should add them on each page, or just to the bottom of the https://github.com/compoundjs/guides README?

Reply to this email directly or view it on GitHub: https://github.com/compoundjs/guides/pull/15#issuecomment-16789470

compoundjs / guides

Added initial text for "views" page. #15

Concerning the `##Authors` section, do you mean we should add them on each page, or just to the bottom of the https://github.com/compoundjs/guides README?

compoundjs / guides

Added initial text for "views" page. #15

Concerning the ##Authors section, do you mean we should add them on each page, or just to the bottom of the https://github.com/compoundjs/guides README?

Concerning the `##Authors` section, do you mean we should add them on each page, or just to the bottom of the https://github.com/compoundjs/guides README?