Page MenuHomeFreeBSD

Add a bit about how to ask for an exp-run.
ClosedPublic

Authored by mat on Aug 15 2016, 10:45 AM.
Tags
None
Referenced Files
Unknown Object (File)
Mar 4 2024, 2:40 PM
Unknown Object (File)
Dec 23 2023, 2:53 AM
Unknown Object (File)
Nov 21 2023, 12:14 AM
Unknown Object (File)
Nov 5 2023, 3:25 PM
Unknown Object (File)
Oct 19 2023, 10:35 PM
Unknown Object (File)
Oct 4 2023, 2:18 PM
Unknown Object (File)
Sep 30 2023, 2:20 PM
Unknown Object (File)
Sep 18 2023, 9:51 PM

Details

Summary

It seems that people do not find the exp-run flag when opening a PR.

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

mat retitled this revision from to Add a bit about how to ask for an exp-run..
mat updated this object.
mat edited the test plan for this revision. (Show Details)
mat added a reviewer: wblock.
mat added a subscriber: Doc Committers.
brd requested changes to this revision.Aug 15 2016, 11:26 AM
brd added a reviewer: brd.
brd added a subscriber: brd.
brd added inline comments.
en_US.ISO8859-1/articles/committers-guide/article.xml
4877 ↗(On Diff #19276)

s/aswers/answers/

This revision now requires changes to proceed.Aug 15 2016, 11:26 AM
en_US.ISO8859-1/articles/committers-guide/article.xml
4828 ↗(On Diff #19276)

This sentence is a little awkward, maybe:

What is the procedure to request an experimental build of the ports tree, also known as an 'exp-run'?

4833 ↗(On Diff #19276)

s/requires/requests/ ?

4837 ↗(On Diff #19276)

s/Full builds/A full package build/

mat marked 4 inline comments as done.Aug 15 2016, 11:37 AM
mat added inline comments.
en_US.ISO8859-1/articles/committers-guide/article.xml
4833 ↗(On Diff #19276)

I don't know, I want it to be clear that it is not something that is optional :-)

4837 ↗(On Diff #19276)

I kinda liked having it as a plural

mat edited edge metadata.
mat marked 2 inline comments as done.
  • Feedback from @brd.
en_US.ISO8859-1/articles/committers-guide/article.xml
4833 ↗(On Diff #19276)

Sure, but it is optional... :)

4837 ↗(On Diff #19276)

I was just thinking, a full build of what?

en_US.ISO8859-1/articles/committers-guide/article.xml
4833 ↗(On Diff #19276)

And if you don't ask for it and break it, you'll get crucified :-p

4837 ↗(On Diff #19276)

I changed it to "Full package builds"

brd edited edge metadata.
This revision is now accepted and ready to land.Aug 15 2016, 3:53 PM
en_US.ISO8859-1/articles/committers-guide/article.xml
4834 ↗(On Diff #19279)
&a.portmgr; prefers that an exp-run is performed before patches with a large impact to ports or the base system are committed.
4838 ↗(On Diff #19279)

Please, not "you".

<para>Full package builds will be done with the patches
provided by the submitter, and the submitter is required to fix detected
problems before commit.</para>
4853 ↗(On Diff #19279)

No, please, no "you".

Fill in the bug report as normal.
4854 ↗(On Diff #19279)

Negative logic: if !(forget). Use positive logic:

Remember to attach the patch.
4861 ↗(On Diff #19279)

This is more confusing because it asks for the opposite of what is needed.

Also, "you are good" is ...not good.

Please remind me about this later when I have more energy.

4865 ↗(On Diff #19279)

This assumes a certain page layout which might not always be that way. Can probably just say "Set the flags to..."

4868 ↗(On Diff #19279)

No, please not "your" unless absolutely necessary.

Hovering the mouse over any field shows more details.
4877 ↗(On Diff #19279)

s/the &a.portmgr;/&a.portmgr/ (I think).

s/answers back/replies/

4878 ↗(On Diff #19279)

"fallout" might not be clearly defined to the reader.

4879 ↗(On Diff #19279)

Please, no "you" or "your" except when needed.

The fallout might be a bug in the original patch or other ports that need to be fixed. 
Both need to be addressed.  Update the patch to repair all the fallout and repeat.
4828 ↗(On Diff #19276)

"What is the procedure" is still a bit redundant. Also, "test" is helpful to make the purpose clearer.

How can an experimental test build of the ports tree (<emphasis>exp-run</emphasis>) be requested?
mat edited edge metadata.
mat marked 8 inline comments as done.
  • With wblock's comments.
This revision now requires review to proceed.Aug 16 2016, 11:46 AM
en_US.ISO8859-1/articles/committers-guide/article.xml
4834 ↗(On Diff #19279)

Is this the polite way of saying "you have to" ?

4838 ↗(On Diff #19279)

There are "you" and "your" all over the place here, it always was less formal than the rest of this article.

4877 ↗(On Diff #19279)

Without "the" it reads:

When Ports Management Team <portmgr@FreeBSD.org> replies,...
4828 ↗(On Diff #19276)

It sounds better, most other questions start with "What ..." so I went with it :-)

en_US.ISO8859-1/articles/committers-guide/article.xml
4834 ↗(On Diff #19279)

The polite way is "must", like

An exp-run must be completed before patches with a significant ports impact are committed.
4838 ↗(On Diff #19279)

Yes, but we should be working on that. It's not to make it more formal, it's to make the sentences more direct.

4877 ↗(On Diff #19279)

Oops, sorry, thought it was a bare email address. Yes, it needs the "the".

This revision was automatically updated to reflect the committed changes.