emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Org Mode "Contribute", "Maintenance" pages don't give repository.
@ 2021-12-04 20:59 Karl Fogel
  2021-12-04 21:20 ` Daniel Fleischer
  0 siblings, 1 reply; 5+ messages in thread
From: Karl Fogel @ 2021-12-04 20:59 UTC (permalink / raw)
  To: Org Mode

The "Contribute" page at 
https://orgmode.org/worg/org-contribute.html does not mention 
git://git.sv.gnu.org/emacs/org-mode.git .  Actually, now that I 
look around, the "Maintenance" page at 
https://orgmode.org/worg/org-maintenance.html doesn't mention the 
repository address either.  It does mention the word "repository" 
a few times, but never actually links to it.

These oversights would be pretty easy to fix (if there is 
agreement that they shoud be fixed), so I haven't attached a patch 
here.  It would be quick for someone who already maintains those 
pages to make the necessary changes.

The only place I see the repository is at the top of the home page 
of
https://orgmode.org/.  That's nice and prominent :-), but 
developers would probably expect to find the address on those 
other two pages as well.

Best regards,
-Karl


^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Org Mode "Contribute", "Maintenance" pages don't give repository.
  2021-12-04 20:59 Org Mode "Contribute", "Maintenance" pages don't give repository Karl Fogel
@ 2021-12-04 21:20 ` Daniel Fleischer
  2021-12-04 21:50   ` Karl Fogel
  0 siblings, 1 reply; 5+ messages in thread
From: Daniel Fleischer @ 2021-12-04 21:20 UTC (permalink / raw)
  To: Karl Fogel; +Cc: Org Mode

Karl Fogel [2021-12-04 Sat 14:59] wrote:

> The "Contribute" page at https://orgmode.org/worg/org-contribute.html does not mention
> git://git.sv.gnu.org/emacs/org-mode.git .  Actually, now that I look around, the "Maintenance" page at
> https://orgmode.org/worg/org-maintenance.html doesn't mention the repository address either.  It does mention the word
> "repository" a few times, but never actually links to it.

I've added a link to the org-maintenance page but there was a link in
the org-contribute, in the "Your first commit as an Org maintainer"
section. The git.sv.gnu.org is a shorthand for git.savannah.gnu.org.

Thanks for reporting this,

-- 

Daniel Fleischer


^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Org Mode "Contribute", "Maintenance" pages don't give repository.
  2021-12-04 21:20 ` Daniel Fleischer
@ 2021-12-04 21:50   ` Karl Fogel
  2021-12-05  9:40     ` Daniel Fleischer
  0 siblings, 1 reply; 5+ messages in thread
From: Karl Fogel @ 2021-12-04 21:50 UTC (permalink / raw)
  To: Daniel Fleischer; +Cc: Org Mode

On 04 Dec 2021, Daniel Fleischer wrote:
>> The "Contribute" page at 
>> https://orgmode.org/worg/org-contribute.html does not mention
>> git://git.sv.gnu.org/emacs/org-mode.git .  Actually, now that I 
>> look around, the "Maintenance" page at
>> https://orgmode.org/worg/org-maintenance.html doesn't mention 
>> the repository address either.  It does mention the word
>> "repository" a few times, but never actually links to it.
>
>I've added a link to the org-maintenance page but there was a 
>link in
>the org-contribute, in the "Your first commit as an Org 
>maintainer"
>section. The git.sv.gnu.org is a shorthand for 
>git.savannah.gnu.org.
>
>Thanks for reporting this,

Thanks, Daniel!

You're right about repository link on the Contribute page.  It 
might still be good to mention it earlier, like in the "Ways that 
involve programming" section or even just in the first paragraph 
of the page.

The reason I suggest this is that often when someone is hot on the 
trail of debugging something, they haven't yet decided whether 
they want to become a contributor or not.  They just know they 
want to ook at the latest sources so they can first figure out 
more about whatever ${technical_thing} they encountered.  So 
making the latest sources very easy to find is a way of making it 
more likely that someone becomes a contributor, by removing a 
commonly-encountered barrier.

Best regards,
-Karl


^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Org Mode "Contribute", "Maintenance" pages don't give repository.
  2021-12-04 21:50   ` Karl Fogel
@ 2021-12-05  9:40     ` Daniel Fleischer
  2021-12-06 19:17       ` Karl Fogel
  0 siblings, 1 reply; 5+ messages in thread
From: Daniel Fleischer @ 2021-12-05  9:40 UTC (permalink / raw)
  To: Karl Fogel; +Cc: Org Mode

Karl Fogel <kfogel@red-bean.com> writes:

> The reason I suggest this is that often when someone is hot on the trail of debugging something, they haven't yet
> decided whether they want to become a contributor or not.  They just know they want to ook at the latest sources so they
> can first figure out more about whatever ${technical_thing} they encountered.  So making the latest sources very easy to
> find is a way of making it more likely that someone becomes a contributor, by removing a commonly-encountered barrier.

You're right; I'll think of a way to present the git repo link, i.e. the
code earlier and more prominently for those who just want to jump and
examine the code.

-- 

Daniel Fleischer


^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Org Mode "Contribute", "Maintenance" pages don't give repository.
  2021-12-05  9:40     ` Daniel Fleischer
@ 2021-12-06 19:17       ` Karl Fogel
  0 siblings, 0 replies; 5+ messages in thread
From: Karl Fogel @ 2021-12-06 19:17 UTC (permalink / raw)
  To: Daniel Fleischer; +Cc: Org Mode

On 05 Dec 2021, Daniel Fleischer wrote:
>You're right; I'll think of a way to present the git repo link, 
>i.e. the
>code earlier and more prominently for those who just want to jump 
>and
>examine the code.

+1, and thanks!


^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2021-12-06 19:18 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-12-04 20:59 Org Mode "Contribute", "Maintenance" pages don't give repository Karl Fogel
2021-12-04 21:20 ` Daniel Fleischer
2021-12-04 21:50   ` Karl Fogel
2021-12-05  9:40     ` Daniel Fleischer
2021-12-06 19:17       ` Karl Fogel

Code repositories for project(s) associated with this inbox:

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).