You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by Daniel Sahlberg <da...@gmail.com> on 2023/03/02 08:04:52 UTC
Re: svn commit: r1907958 - /subversion/site/staging/reporting-issues.html
Hi,
During the Infra Roundtable yesterday a new self-serve for creating Jira
accounts was announced. While I agree with Karl's 20+ year old e-mail about
issue creations [1], the self-serve will inevitable be found and accounts
will be created even if we don't link to it ourselves. Thus i'm proposing
to add a link to the reporting-issues.html page. The request to add a
reference to a mailing list discussion is intended to encourage people to
actually use the mailing list before creating an issue (and an excuse to
deny an account if an issue has not been discussed on-list).
Please check and feel free to update (in particular any
grammatical/spelling errors).
(In the meantime, I've added a few links in the Jira description pointing
to https://subversion.apache.org/reporting-issues.html).
Kind regards,
Daniel
[1] http://svn_staging/docs/community-guide/issues.html#issues
Den tors 2 mars 2023 kl 08:53 skrev <ds...@apache.org>:
> Author: dsahlberg
> Date: Thu Mar 2 07:53:12 2023
> New Revision: 1907958
>
> URL: http://svn.apache.org/viewvc?rev=1907958&view=rev
> Log:
> In site/staging:
>
> * reporting-issues.html: Add link to the Jira request account self-serve
>
> Modified:
> subversion/site/staging/reporting-issues.html
>
> Modified: subversion/site/staging/reporting-issues.html
> URL:
> http://svn.apache.org/viewvc/subversion/site/staging/reporting-issues.html?rev=1907958&r1=1907957&r2=1907958&view=diff
>
> ==============================================================================
> --- subversion/site/staging/reporting-issues.html (original)
> +++ subversion/site/staging/reporting-issues.html Thu Mar 2 07:53:12 2023
> @@ -48,6 +48,13 @@
> your own complaints and requests, but in doing so, you'll increase
> the likelihood that we'll recognize them as constructive.</p>
>
> +<p>You need to have an account to create issues. If you are already
> + a committer, use your @apache.org account to sign in. Otherwise,
> + you can apply for an account using the <a
> + href="https://selfserve.apache.org/jira-account.html"
> + >Self-serve Portal</a>, please add a reference to the mailing
> + list discussion in the "Tell us a little [...]" input field to
> + speed up the review process.</p>
>
> <div class="h2" id="queries">
> <h2>Handy Dandy Issue Tracker Queries
>
>
>
Re: svn commit: r1907958 - /subversion/site/staging/reporting-issues.html
Posted by Karl Fogel <kf...@red-bean.com>.
On 02 Mar 2023, Daniel Sahlberg wrote:
>Hi,
>
>During the Infra Roundtable yesterday a new self-serve for
>creating
>Jira accounts was announced. While I agree with Karl's 20+ year
>old
>e-mail about issue creations [1], the self-serve will inevitable
>be
>found and accounts will be created even if we don't link to it
>ourselves. Thus i'm proposing to add a link to the
>reporting-issues.html page. The request to add a reference to a
>mailing list discussion is intended to encourage people to
>actually
>use the mailing list before creating an issue (and an excuse to
>deny
>an account if an issue has not been discussed on-list).
Wow, that is indeed an old email. By the way, your reference
accidentally pointed to a staging site -- here's the real URL:
https://subversion.apache.org/docs/community-guide/issues.html#issues
Now, issue trackers have changed a lot since then. Many modern
trackers support conversational threads in a mailing-list-like
way, so some of what that page says isn't as true today as it was
in 2002. I still think it's a good idea for people to post on the
list or in some other non-tracker forum before filing an issue,
but the argument for why is perhaps weaker now than it used to be.
Thanks for noticing the new self-serve and thinking ahead to the
adjustment we should make!
Best regards,
-Karl
>Please check and feel free to update (in particular any
>grammatical/
>spelling errors).
>
>(In the meantime, I've added a few links in the Jira description
>pointing to https://subversion.apache.org/reporting-issues.html).
>
>Kind regards,
>Daniel
>
>[1] http://svn_staging/docs/community-guide/issues.html#issues
>
>Den tors 2 mars 2023 kl 08:53 skrev <ds...@apache.org>:
>
> Author: dsahlberg
> Date: Thu Mar 2 07:53:12 2023
> New Revision: 1907958
>
> URL: http://svn.apache.org/viewvc?rev=1907958&view=rev
> Log:
> In site/staging:
>
> * reporting-issues.html: Add link to the Jira request account
> self-serve
>
> Modified:
> subversion/site/staging/reporting-issues.html
>
> Modified: subversion/site/staging/reporting-issues.html
> URL: http://svn.apache.org/viewvc/subversion/site/staging/
> reporting-issues.html?rev=1907958&r1=1907957&r2=1907958&view=diff
> =================================================================
> =============
> --- subversion/site/staging/reporting-issues.html (original)
> +++ subversion/site/staging/reporting-issues.html Thu Mar 2
> 07:53:12 2023
> @@ -48,6 +48,13 @@
> your own complaints and requests, but in doing so, you'll
> increase
> the likelihood that we'll recognize them as
> constructive.</p>
>
> +<p>You need to have an account to create issues. If you are
> already
> + a committer, use your @apache.org account to sign in.
> Otherwise,
> + you can apply for an account using the <a
> + href="https://selfserve.apache.org/jira-account.html"
> + >Self-serve Portal</a>, please add a reference to the
> mailing
> + list discussion in the "Tell us a little [...]" input
> field
> to
> + speed up the review process.</p>
>
> <div class="h2" id="queries">
> <h2>Handy Dandy Issue Tracker Queries
>
>
Re: svn commit: r1907958 - /subversion/site/staging/reporting-issues.html
Posted by Daniel Sahlberg <da...@gmail.com>.
Den fre 3 mars 2023 kl 02:50 skrev Nathan Hartman <hartman.nathan@gmail.com
>:
> On Thu, Mar 2, 2023 at 3:05 AM Daniel Sahlberg
> <da...@gmail.com> wrote:
> >
> > During the Infra Roundtable yesterday a new self-serve for creating Jira
> accounts was announced.
>
> Thanks for doing that! I meant to notify our dev@ list for those who
> didn't see the announcement, but you beat me to it.
>
> > Please check and feel free to update (in particular any
> grammatical/spelling errors).
>
> I would recommend to just change the comma before please to a period:
>
> >> + you can apply for an account using the <a
> >> + href="https://selfserve.apache.org/jira-account.html"
> >> + >Self-serve Portal</a>, please add a reference to the mailing
>
> So it reads: "Self-serve Portal</a>. Please"
>
> Otherwise, looks good. I agree that people will find the link, so may
> as well document it.
>
Thanks to both Nathan and Karl for the feedback and encouragement. I've
adjusted as above and merged to trunk. It is now available on the website.
Kind regards,
Daniel
Re: svn commit: r1907958 - /subversion/site/staging/reporting-issues.html
Posted by Nathan Hartman <ha...@gmail.com>.
On Thu, Mar 2, 2023 at 3:05 AM Daniel Sahlberg
<da...@gmail.com> wrote:
>
> During the Infra Roundtable yesterday a new self-serve for creating Jira accounts was announced.
Thanks for doing that! I meant to notify our dev@ list for those who
didn't see the announcement, but you beat me to it.
> Please check and feel free to update (in particular any grammatical/spelling errors).
I would recommend to just change the comma before please to a period:
>> + you can apply for an account using the <a
>> + href="https://selfserve.apache.org/jira-account.html"
>> + >Self-serve Portal</a>, please add a reference to the mailing
So it reads: "Self-serve Portal</a>. Please"
Otherwise, looks good. I agree that people will find the link, so may
as well document it.
Cheers,
Nathan