[Starlingx-discuss] Full process to update/add documentation pages (gerrit review push issue)

Jones, Bruce E bruce.e.jones at intel.com
Thu Sep 12 17:59:06 UTC 2019

My workflow is different.

# git commit -s 
<edit commit message, add story number, etc...>
# git review

The tools want a specific format in the commit message, which is easier for me to get right this way.


-----Original Message-----
From: Dominig ar Foll (Intel Open Source) [mailto:dominig.arfoll at fridu.net] 
Sent: Thursday, September 12, 2019 10:43 AM
To: Ildiko Vancsa <ildiko.vancsa at gmail.com>
Cc: starlingx-discuss at lists.starlingx.io
Subject: Re: [Starlingx-discuss] Full process to update/add documentation pages (gerrit review push issue)

On 12/09/2019 18:41, Ildiko Vancsa wrote:
> Hi Dominig,
> Which steps have you performed before trying to upload your commit to Gerrit?
> Have you initialized your local repo with ‘git review -s’ for instance after cloning it?
> I’m also a little confused by the command in your mail: git review -t "initial creation Doc page Navigate Git Code story/2005184”
> ‘-t’ specifies the Gerrit topic which should be not more than for instance 'story/2005184’. It looks like you are trying to add the commit message title to the topic which is a bit too long as topic text.
> If you are on IRC (#starlingx channel on Freenode) I can help figuring this out in a more synchronous way.
OK, it seems that Geoffroy as usual had a great idea to work around the issue. Geoffroy thanks your trick of removing spaces, worked.

When it come to the user of -t, I guessed from the git-review that adding a topic would be helpful, but without guidance on documentation, I did like what I was doing in AGL.

So I did clone the documentation repo
   git clone https://opendev.org/starlingx/docs
   git clone https://opendev.org/starlingx/specs

 # added my page with my prefered text editor  # then
  git commit -sam "initial creation Doc page Navigate Git Code story/2005184"
  git review -t "initial creation Doc page Navigate Git Code story/2005184"
 # !!oups that did not work. I got a not that helpful error message
  git review -t "initial_creation_Doc_page_Navigate_Git_Code_story/2005184"
 # that one was accepted with a warning on the length of my topic.

If someone knows what should actually be done, it would be nice to add it to the documentation on how to improve documentation.
So far the only guidance is :
  and then submit the changes to Gerrit for approval.

Dominig ar Foll
Senior Software Architect
Intel Open Source Technology Centre

Starlingx-discuss mailing list
Starlingx-discuss at lists.starlingx.io

More information about the Starlingx-discuss mailing list