pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feed"TL;DR:"
6+ messages / 4 participants
[nested] [flat]
* "TL;DR:"
@ 2012-04-25 15:30 Kevin Grittner <Kevin.Grittner@wicourts.gov>
0 siblings, 2 replies; 6+ messages in thread
From: Kevin Grittner @ 2012-04-25 15:30 UTC (permalink / raw)
To: pgsql-docs
[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/Guide_to_reporting_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
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: "TL;DR:"
@ 2012-04-25 15:49 Tom Lane <tgl@sss.pgh.pa.us>
parent: Kevin Grittner <Kevin.Grittner@wicourts.gov>
1 sibling, 0 replies; 6+ messages in thread
From: Tom Lane @ 2012-04-25 15:49 UTC (permalink / raw)
To: Kevin Grittner <Kevin.Grittner@wicourts.gov>; +Cc: pgsql-docs
"Kevin Grittner" <Kevin.Grittner@wicourts.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?
> http://wiki.postgresql.org/wiki/Guide_to_reporting_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
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: "TL;DR:"
@ 2012-04-25 17:17 Greg Sabino Mullane <greg@turnstep.com>
parent: Kevin Grittner <Kevin.Grittner@wicourts.gov>
1 sibling, 1 reply; 6+ messages in thread
From: Greg Sabino Mullane @ 2012-04-25 17:17 UTC (permalink / raw)
To: pgsql-docs
-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160
> 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@turnstep.com
PGP Key: 0x14964AC8 201204251316
http://biglumber.com/x/web?pk=2529DF6AB8F79407E94445B4BC9B906714964AC8
-----BEGIN PGP SIGNATURE-----
iEYEAREDAAYFAk+YMZ8ACgkQvJuQZxSWSsiOIQCg64VLuuwpqXhL8x5Vi2zmStYp
SrIAoO2zb9lXKuPOhDRYRbQCB4Wvmfnv
=8nCh
-----END PGP SIGNATURE-----
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: "TL;DR:"
@ 2012-04-25 17:35 Kevin Grittner <Kevin.Grittner@wicourts.gov>
parent: Greg Sabino Mullane <greg@turnstep.com>
0 siblings, 1 reply; 6+ messages in thread
From: Kevin Grittner @ 2012-04-25 17:35 UTC (permalink / raw)
To: pgsql-docs; Greg Sabino Mullane <greg@turnstep.com>
> "Kevin Grittner" <Kevin.Grittner@wicourts.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@sss.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@turnstep.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.
-Kevin
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: "TL;DR:"
@ 2012-04-27 00:22 Selena Deckelmann <selena@chesnok.com>
parent: Kevin Grittner <Kevin.Grittner@wicourts.gov>
0 siblings, 1 reply; 6+ messages in thread
From: Selena Deckelmann @ 2012-04-27 00:22 UTC (permalink / raw)
To: Kevin Grittner <Kevin.Grittner@wicourts.gov>; +Cc: pgsql-docs@postgresql.org, Greg Sabino Mullane <greg@turnstep.com>
On Wed, Apr 25, 2012 at 10:35 AM, Kevin Grittner <
Kevin.Grittner@wicourts.gov> wrote:
> > "Kevin Grittner" <Kevin.Grittner@wicourts.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@sss.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@turnstep.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
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: "TL;DR:"
@ 2012-04-27 00:46 Selena Deckelmann <selena@chesnok.com>
parent: Selena Deckelmann <selena@chesnok.com>
0 siblings, 0 replies; 6+ messages in thread
From: Selena Deckelmann @ 2012-04-27 00:46 UTC (permalink / raw)
To: Kevin Grittner <Kevin.Grittner@wicourts.gov>; Greg Sabino Mullane <greg@turnstep.com>; +Cc: pgsql-docs
On Thu, Apr 26, 2012 at 5:22 PM, Selena Deckelmann <selena@chesnok.com>wrote:
>
>
> On Wed, Apr 25, 2012 at 10:35 AM, Kevin Grittner <
> Kevin.Grittner@wicourts.gov> wrote:
>
>> > "Kevin Grittner" <Kevin.Grittner@wicourts.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@sss.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@turnstep.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
^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2012-04-27 00:46 UTC | newest]
Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2012-04-25 15:30 "TL;DR:" Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-04-25 15:49 ` Tom Lane <tgl@sss.pgh.pa.us>
2012-04-25 17:17 ` Greg Sabino Mullane <greg@turnstep.com>
2012-04-25 17:35 ` Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-04-27 00:22 ` Selena Deckelmann <selena@chesnok.com>
2012-04-27 00:46 ` Selena Deckelmann <selena@chesnok.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox