Re: RFC: Git for docs writers

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 





On Thu, Jan 2, 2020 at 10:44 PM Ben Cotton <bcotton@xxxxxxxxxx> wrote:
On Wed, Dec 18, 2019 at 6:56 AM Brian (bex) Exelbierd
<bexelbie@xxxxxxxxxx> wrote:
>
> I have an alternative approach that I like that I feel like makes it easier to keep the fork in sync.  This feels like a huge point of friction for new users and this is hte only reason I am proposing it.
>
I think I captured this in the latest version, can you please take a
look and make sure I'm not misrepresenting it?
https://fedoraproject.org/wiki/User:Bcotton/git-for-docs-writers

I suggest the following changes:

1. Delete the first section under "🔗 Before your first edit" and fold it into the detail that follows.

This requires the fork to be created as part of hte major step 2 below that heading.  I would rewrite "Go to your forked Pagure repo" as "Create your fork repo" and make step 1 of it to hit hte fork button in the web interface.

This change should allow for to be created in a smooth single flow with no back/forths in the web interface.

regards,

bex


On Mon, Dec 23, 2019 at 12:10 PM mowestusa <mowestusa@xxxxxxxxx> wrote:
>
> 3. https://fedoraproject.org/wiki/User:Bcotton/git-for-docs-writers#Before_every_contribution
> - Would it be a good idea to add in this section the following additional command?
>
> git push origin master
>
Good point! I don't use the web interface much, so I didn't think of
that. I added it to my draft.

> 4. The following question came up when I started making edits that I didn't have the time to finish today.
> - I understand that ++git checkout -b branch_name++ puts me into my working branch that I have created.
> - However if I need to close my text editor and come back to my edits later, how do I know if I'm still making those edits in my "work in progress" branch instead of my forked "master" branch?
> - Do I fire up a terminal and just run ++git checkout -b branch_name++ again?
> - Or is there a "status" type command that I would run from the terminal to know what branch I'm making my edits in?
>
`git branch` will tell you the current branch, along with the other
branches it knows about. Your current branch starts with *. I added  a
tip to the "Making a contribution" section:
https://fedoraproject.org/wiki/User:Bcotton/git-for-docs-writers#Making_a_contribution

--
Ben Cotton
He / Him / His
Fedora Program Manager
Red Hat
TZ=America/Indiana/Indianapolis
_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx


--
Brian "bex" Exelbierd (he/him/his)
RHEL Product Management & Community Architect
@bexelbie | http://www.winglemeyer.org
bexelbie@xxxxxxxxxx
_______________________________________________
docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux