threads / rfc / 44931

[RFC] what content should go in https://git-scm.com/doc/ext

Subject: [RFC] what content should go in https://git-scm.com/doc/ext

## tl;dr

3 messages between Jan 21, 2017 and Jan 25, 2017.

replies: 2people: 2as markdown or json

Jeff King· Jan 21, 2017, 13:55 UTC · lore
I'm wondering if anybody has opinions on:
  https://github.com/git/git-scm.com/pull/924

(and I suspect most people in this community do not read pull requests there, hence this post).

Basically, we maintain a list of links to outside documentation, as well as to books. Somebody has requested a link to their paid tutorial course. How should we handle it?

If the resource is valuable, then it may make sense to link to it, even if it costs money. We already do this with book links, and my policy has been to link any relevant book that is requested (I don't read them for quality, so I have no opinions).

Should we do the same for tutorial content like this?
-Peff
Christian Couder· Jan 22, 2017, 19:13 UTC · re: Jeff King · lore

Re: [RFC] what content should go in https://git-scm.com/doc/ext

On Sat, Jan 21, 2017 at 2:55 PM, Jeff King <peff@peff.net> wrote:
Show 6 quoted lines
> I'm wondering if anybody has opinions on:
>
>   https://github.com/git/git-scm.com/pull/924
>
> (and I suspect most people in this community do not read pull requests
> there, hence this post).
Yeah, thanks for posting it here.
> Basically, we maintain a list of links to outside documentation, as well
> as to books. Somebody has requested a link to their paid tutorial
> course. How should we handle it?
I think it depends if you are ready and willing to handle more changes.
Show 6 quoted lines
> If the resource is valuable, then it may make sense to link to it, even
> if it costs money. We already do this with book links, and my policy has
> been to link any relevant book that is requested (I don't read them for
> quality, so I have no opinions).
>
> Should we do the same for tutorial content like this?

It could make sense to link to tutorial content, and then it could also make sense to link to trainings (online and maybe offline too), but my fear is that you could then have many people who want to advertise their tutorials and trainings, and that it might be difficult to draw a line while keeping the playing field even.

But maybe it's worth trying anyway.
Jeff King· Jan 25, 2017, 18:42 UTC · re: Christian Couder · lore

Re: [RFC] what content should go in https://git-scm.com/doc/ext

On Sun, Jan 22, 2017 at 08:13:53PM +0100, Christian Couder wrote:
Show 5 quoted lines
> > Basically, we maintain a list of links to outside documentation, as well
> > as to books. Somebody has requested a link to their paid tutorial
> > course. How should we handle it?
> 
> I think it depends if you are ready and willing to handle more changes.

I don't clicking "merge" on more changes if people are willing to do the design work.

Show 9 quoted lines
> > Should we do the same for tutorial content like this?
> 
> It could make sense to link to tutorial content, and then it could
> also make sense to link to trainings (online and maybe offline too),
> but my fear is that you could then have many people who want to
> advertise their tutorials and trainings, and that it might be
> difficult to draw a line while keeping the playing field even.
> 
> But maybe it's worth trying anyway.

I think I'm inclined to try it, as long as it's kept in a separate "paid training" section, and is open to everybody. If it becomes a burden, we can cut it out later. I think the important thing is that it be equally open to everybody or nobody, but not just "some". So we'll go with everybody for now, and switch to nobody later if need be.

-Peff

← back to recent threads