On 11/01/2012 07:02 PM, Chad Engler wrote:Ill repeat myself for the third time now: If you see something and are
confused on what it means, Google is a great starting point. Had you
attempting to figure it out on your own, you would have seen the first
link, felt silly, and moved on.
-Chad
*From:*
nodejs@googlegroups.com *On
Behalf Of *SL
*Sent:* Thursday, November 01, 2012 1:01 PM
*To:*
nodejs@googlegroups.com*Subject:* Re: [nodejs] Re: process.env - documentation?
Ok, last post as the vibe here is a distinctly unfriendly... It's quite
simple: When I read 'see environ(7)' I assumed that was a reference to
another part of the node docs. When a reference is made to another
source, I'm used to seeing the source named. If it had said 'see:
man-pages environ(7)' there probably would have been no misunderstanding.
On 1 November 2012 17:58, Chad Engler wrote:
I really think all of this could have been avoided, and new knowledge
consumed using this simple process that has guided me for years:
1. Encounter unknown term, phrase, or idea
2. Copy unknown term, phrase, or idea to clipboard
3. Paste unknown term, phrase, or idea into a search engine search
bar (I tend to use Google)
4. Select “Search”
5. View results, which 98% of the time will clear up confusion.
If this process fails, then repeat using similar terms. If that /also/
fails, then I usually head to StackOverflow/mailing lists.
My point was there was no attempt to solve this besides “tell me what I
need to know” and “We should fix the docs so people who have never
developed before can use them.”
-Chad
*From:*
nodejs@googlegroups.com *On
Behalf Of *SL
*Sent:* Thursday, November 01, 2012 12:49 PM
*To:*
nodejs@googlegroups.com *Subject:* Re: [nodejs] Re: process.env - documentation?
As you guessed, I'm developing on Windows. Thanks for the
understanding! Yes a link would have avoided all confusion.
On 1 November 2012 17:42, Tim Caswell wrote:
I've been using since before it was popular. Back in the early days,
the docs for node were full of references to linux man pages like
this. My background was scripting languages and I had never done any
C programming so I had no clue what readdir(3) meant. To open a file
back then you had to manually bitwise OR the various unix flags
together yourself. (Using "r", "w", "a", etc was an addition I made)
Things now are much easier for people without a C background and there
are many fewer parts left in the docs that assume knowledge of man
pages.
That said, I did eventually figure out it was referencing man pages.
I was a linux user after all, I had just never used man to lookup C
APis.
How about we just link to one of the man mirrors in the API docs? I
was an experienced linux user and I still didn't know what the docs
were talking about, I can only imagine how confused windows users
would be.
On Thu, Nov 1, 2012 at 11:34 AM, Chad Engler wrote:It wasn’t condescending; “topic(page#)” like “environ(7)” is a very common
way to express man pages, and if you aren’t aware of what the user
environment is you should probably do more research. Had you typed
“environ(7)” into google before getting butthurt at the docs, you probably
would have found out exactly what it was with no help from anyone. There is
no reason to repost the manual page since there is already a manual page for
it, the docs are fine the way they are; you just need to try to look a
little harder, or be grateful when people help.
-Chad
From:
nodejs@googlegroups.com On Behalf Of
SL
Sent: Thursday, November 01, 2012 12:16 PM
To:
nodejs@googlegroups.com > Subject: Re: [nodejs] Re: process.env - documentation?
Wow, thanks for the condescending and arrogant comment! I'm not
suggesting
there should be a 'tutorial' about any of those things you mentioned.
However the docs at the moment are IMO a bit ambiguous about this
point - it
just says "An object containing the user environment. See environ(7)." I
didn't realise immediately that this is talking about the OS environment
variables - I'm sure I'm not the only one.
On 1 November 2012 14:13, Matt wrote:
If the docs covered every aspect of how programming networks, child
processes, systems and filesystems worked they would be huge.
There's a place for tutorials though - but it's not in the core docs IMHO.
If you don't know what an environment variable is then you have some basic
learning to do before diving straight into programming.
On Wed, Oct 31, 2012 at 7:28 PM, SL wrote:
Or we could make the docs a bit clearer...
On 31 October 2012 18:46, Jorge
<jorge%
jorgechamorro.com@gtempaccount.comwrote:
On 31 oct, 17:26, Scott Elcomb wrote:On Wed, Oct 31, 2012 at 10:59 AM, Jorge
wrote:
On Oct 31, 2:04 pm, Bgsosh wrote:
Hi, I'm tring to understand the structure of the process.env object,
but
the online docs just say 'An object containing the user environment.
See
environ(7).'
I can't find 'environ(7)' (whatever that is!). Is this documented
somewhere?
Type this in the terminal:
$ man 7 environ
That'd be tricky for Windows users to do if they're not running a
*nix-like shell. (Cygwin comes to mind)
I'd imagine the best bet for Windows users would be to search for "man
7 environ" on the web to find a copy of the relevant man page; there
are a number of mirrors like the one Adam suggested.
(BTW, for those not familiar with man pages, see also
<
http://en.wikipedia.org/wiki/Man_page>)
Perhaps Windowzs users should better search for "environment
variables" @ msdn or something, I guess, yeah.
--
Jorge.
--
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en--
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en--
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en--
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en--
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en --
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en--
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en--
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en--
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en--
Job Board:
http://jobs.nodejs.org/Posting guidelines:
https://github.com/joyent/node/wiki/Mailing-List-Posting-GuidelinesYou received this message because you are subscribed to the Google
Groups "nodejs" group.
To post to this group, send email to
nodejs@googlegroups.comTo unsubscribe from this group, send email to
nodejs+
unsubscribe@googlegroups.comFor more options, visit this group at
http://groups.google.com/group/nodejs?hl=en?hl=en Groups "nodejs" group.
