dbTalk Databases Forums  

[DOCS] "TL;DR:"

mailing.database.pgsql-docs mailing.database.pgsql-docs


Discuss [DOCS] "TL;DR:" in the mailing.database.pgsql-docs forum.



Reply
 
Thread Tools Display Modes
  #1  
Old   
Kevin Grittner
 
Posts: n/a

Default [DOCS] "TL;DR:" - 04-25-2012 , 10:30 AM






[I had a bit of trouble picking which list to use; I guess Wiki
pages are part of our docs, in a way...]

How do people feel about "TL;DR:" being used at the start of a Wiki
page to which we want to direct users?

http://wiki.postgresql.org/wiki/Guid...rting_problems

I'll go first -- I hate it.

Every time I bring up the page before referring a user there, I find
that those geeky capital letters in bold screaming at me are
distracting and annoying. Since Craig obviously doesn't, I didn't
want to just change it without other input.

Personally, I think "keep reading" in bold probably covers it.

-Kevin

--
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

Reply With Quote
  #2  
Old   
Tom Lane
 
Posts: n/a

Default Re: [DOCS] "TL;DR:" - 04-25-2012 , 10:49 AM






"Kevin Grittner" <Kevin.Grittner (AT) wicourts (DOT) gov> writes:
Quote:
How do people feel about "TL;DR:" being used at the start of a Wiki
page to which we want to direct users?

http://wiki.postgresql.org/wiki/Guid...rting_problems

I'll go first -- I hate it.
I think it's a pretty lousy way to start off this page in particular;
way too flippant for something we point newcomers to when they ask
for help. +1 for rewriting in a more formal style.

regards, tom lane

--
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

Reply With Quote
  #3  
Old   
Greg Sabino Mullane
 
Posts: n/a

Default Re: [DOCS] "TL;DR:" - 04-25-2012 , 12:17 PM



-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160


Quote:
How do people feel about "TL;DR:" being used at the start of a Wiki
page to which we want to direct users?
Very inappropriate there: remove 'em!

- --
Greg Sabino Mullane greg (AT) turnstep (DOT) com
PGP Key: 0x14964AC8 201204251316
http://biglumber.com/x/web?pk=2529DF...9B906714964AC8
-----BEGIN PGP SIGNATURE-----

iEYEAREDAAYFAk+YMZ8ACgkQvJuQZxSWSsiOIQCg64VLuuwpqX hL8x5Vi2zmStYp
SrIAoO2zb9lXKuPOhDRYRbQCB4Wvmfnv
=8nCh
-----END PGP SIGNATURE-----



--
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

Reply With Quote
  #4  
Old   
Kevin Grittner
 
Posts: n/a

Default Re: [DOCS] "TL;DR:" - 04-25-2012 , 12:35 PM



Quote:
"Kevin Grittner" <Kevin.Grittner (AT) wicourts (DOT) gov> writes:
How do people feel about "TL;DR:" being used at the start of a
Wiki page to which we want to direct users?
Tom Lane <tgl (AT) sss (DOT) pgh.pa.us> wrote:
Quote:
I think it's a pretty lousy way to start off this page in
particular; way too flippant for something we point newcomers to
when they ask for help. +1 for rewriting in a more formal style.
"Greg Sabino Mullane" <greg (AT) turnstep (DOT) com> wrote:
Quote:
Very inappropriate there: remove 'em!
I took a shot at reworking the portion ahead of the TOC, but I know
there are better wordsmiths than I out there. If anyone wants to
redo it, I won't be offended.

I have a feeling the "Why were you sent this link?" section is a
little harsh, too; but haven't taken a run at that yet.

-Kevin

--
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

Reply With Quote
  #5  
Old   
Selena Deckelmann
 
Posts: n/a

Default Re: [DOCS] "TL;DR:" - 04-26-2012 , 07:22 PM



On Wed, Apr 25, 2012 at 10:35 AM, Kevin Grittner <
Kevin.Grittner (AT) wicourts (DOT) gov> wrote:

Quote:
"Kevin Grittner" <Kevin.Grittner (AT) wicourts (DOT) gov> writes:
How do people feel about "TL;DR:" being used at the start of a
Wiki page to which we want to direct users?

Tom Lane <tgl (AT) sss (DOT) pgh.pa.us> wrote:
I think it's a pretty lousy way to start off this page in
particular; way too flippant for something we point newcomers to
when they ask for help. +1 for rewriting in a more formal style.

"Greg Sabino Mullane" <greg (AT) turnstep (DOT) com> wrote:
Very inappropriate there: remove 'em!

I took a shot at reworking the portion ahead of the TOC, but I know
there are better wordsmiths than I out there. If anyone wants to
redo it, I won't be offended.

I have a feeling the "Why were you sent this link?" section is a
little harsh, too; but haven't taken a run at that yet.


Reworded it. Now looking at the rest of the document.

-selena


--
http://chesnok.com

Reply With Quote
  #6  
Old   
Selena Deckelmann
 
Posts: n/a

Default Re: [DOCS] "TL;DR:" - 04-26-2012 , 07:46 PM



On Thu, Apr 26, 2012 at 5:22 PM, Selena Deckelmann <selena (AT) chesnok (DOT) com>wrote:

Quote:

On Wed, Apr 25, 2012 at 10:35 AM, Kevin Grittner
Kevin.Grittner (AT) wicourts (DOT) gov> wrote:

"Kevin Grittner" <Kevin.Grittner (AT) wicourts (DOT) gov> writes:
How do people feel about "TL;DR:" being used at the start of a
Wiki page to which we want to direct users?

Tom Lane <tgl (AT) sss (DOT) pgh.pa.us> wrote:
I think it's a pretty lousy way to start off this page in
particular; way too flippant for something we point newcomers to
when they ask for help. +1 for rewriting in a more formal style.

"Greg Sabino Mullane" <greg (AT) turnstep (DOT) com> wrote:
Very inappropriate there: remove 'em!

I took a shot at reworking the portion ahead of the TOC, but I know
there are better wordsmiths than I out there. If anyone wants to
redo it, I won't be offended.

I have a feeling the "Why were you sent this link?" section is a
little harsh, too; but haven't taken a run at that yet.


Reworded it. Now looking at the rest of the document.

Ok, I made some changes. The numbering really stymied me.

Greg -- is there a better way to manage the numbering? One of the problems
with the long lists is that they are not numbered - so if you're a poor bug
reporter trying to scan that list, you lose your place. But I want the
formatting to be consistent without having to give numbers to the
sub-points.

-selena


--
http://chesnok.com

Reply With Quote
Reply




Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

vB code is On
Smilies are On
[IMG] code is On
HTML code is Off



Powered by vBulletin Version 3.5.3
Copyright ©2000 - 2013, Jelsoft Enterprises Ltd.