Getting the release notes to Bodhi

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Add Bodhi request)
Line 1: Line 1:
 
{{header|docs}}
 
{{header|docs}}
  
Before beginning this process, be sure you have been through the [[Preparing the Release Notes for final release]].
+
Before beginning this process, be sure you have been through the [[Preparing the Release Notes for final release]] and you have installed doc-publican-rpm.
  
1. Build the package with doc-publican-rpm - you will need the tar and spec files so keep track of them
+
1. Check the release notes out of the release git repo
 +
fedpkg co fedora-release-notes
 +
 
 +
2. Change into the local repo folder
 +
cd fedora-release-notes
 +
 
 +
3. copy fedora-release-notes.spec to the directory you will use to build the RPM.
 +
 
 +
4. Change to that directory and add a changelog entry to the copy of fedora-release-notes.spec.  Also, in the description update the Fedora release number if needed. There is no need to change anything else.  Rename that file to fedora-release-notes.spec.old.
 +
 
 +
5. Create doc-publican-rpm.config following the instructions in the man page
 +
 
 +
6. Build the package with doc-publican-rpm - you will need the tar and spec files so keep track of them
 
{{admon/warning|You must not do a publican publish between the publican build and making the tar.  |publican publish corrupts the htmls}}
 
{{admon/warning|You must not do a publican publish between the publican build and making the tar.  |publican publish corrupts the htmls}}
  
2. Do a koji scratch build of the SRPM for both the next release and rawhide to ensure a clean build
+
7. Do a koji scratch build of the SRPM for both the next release and rawhide to ensure a clean build
 
   pushd ~/rpmbuild/SRPMS
 
   pushd ~/rpmbuild/SRPMS
   koji build --scratch dist-rawhide fedora-release-notes-x.y.z.fc13.src.rpm
+
   koji build --scratch dist-rawhide fedora-release-notes-x.y.z.fc16.src.rpm
   koji build --scratch dist-f14 fedora-release-notes-x.y.z.fc13.src.rpm
+
   koji build --scratch dist-f17 fedora-release-notes-x.y.z.fc16.src.rpm
 
   popd
 
   popd
  
3. Check the release notes out of the release git repo
+
8. Switch back to the directory created by fedpkg
fedpkg co fedora-release-notes
+
 
+
4. Change into the local repo folder
+
cd fedora-release-notes
+
  
5. Switch to the branch for the next release
+
9. Switch to the branch for the next release
  fedpkg switch-branch f14
+
  fedpkg switch-branch f17
  
6. Post the d-p-r produced tar to the repo
+
10. Post the d-p-r produced tar to the repo
 
  fedpkg new-sources somewhere/fedora-release-notes-x.y.z.tar.gz
 
  fedpkg new-sources somewhere/fedora-release-notes-x.y.z.tar.gz
  
7. Copy the spec file into the local repo copy
+
11. Copy the spec file into the local repo copy
 
  cp somewhere/fedora-release-notes.spec .
 
  cp somewhere/fedora-release-notes.spec .
  
8. Add the changed spec file to the commit (fedpkg already added the tar)
+
12. Add the changed spec file to the commit (fedpkg already added the tar)
 
  git add fedora-release-notes.spec
 
  git add fedora-release-notes.spec
  
9. Commit the tar and specfile
+
13. Commit the tar and specfile
 
  git commit -m "yada yada yada"
 
  git commit -m "yada yada yada"
  
10. Push the changes up to fp.o
+
14. Push the changes up to fp.o
 
   git push
 
   git push
  
11. Build the package from the repo
+
15. Build the package from the repo
 
   fedpkg build
 
   fedpkg build
  
12. Create a Bodhi update request
+
16. Create a Bodhi update request
 
   fedpkg update
 
   fedpkg update
  
13. Repeat steps 5-11 for rawhide.  (Note that even though fedpkg new-sources indicates that the sources are already uploaded, you still need to execute the command to indicate that the new sources apply to the rawhide branch.) the rawhide package does not need to go to Bodhi.
+
17. Repeat steps 5-11 for rawhide.  (Note that even though fedpkg new-sources indicates that the sources are already uploaded, you still need to execute the command to indicate that the new sources apply to the rawhide branch.) the rawhide package does not need to go to Bodhi.
  
14. Watch the progress of the builds on Koji (http://koji.fedoraproject.org/koji/).  When complete, log on to Bodhi and request stable.
+
18. Watch the progress of the builds on Koji (http://koji.fedoraproject.org/koji/).  When complete, log on to Bodhi and request stable.
  
15. Recruit your friends and neighbors to give the document karma (https://fedoraproject.org/wiki/Giving_a_document_karma)
+
19. Recruit your friends and neighbors to give the document karma (https://fedoraproject.org/wiki/Giving_a_document_karma)
  
 
[[Category:Docs Project process]]
 
[[Category:Docs Project process]]

Revision as of 19:48, 30 April 2012

DocsProject Header docTeam1.png


Before beginning this process, be sure you have been through the Preparing the Release Notes for final release and you have installed doc-publican-rpm.

1. Check the release notes out of the release git repo

fedpkg co fedora-release-notes

2. Change into the local repo folder

cd fedora-release-notes

3. copy fedora-release-notes.spec to the directory you will use to build the RPM.

4. Change to that directory and add a changelog entry to the copy of fedora-release-notes.spec. Also, in the description update the Fedora release number if needed. There is no need to change anything else. Rename that file to fedora-release-notes.spec.old.

5. Create doc-publican-rpm.config following the instructions in the man page

6. Build the package with doc-publican-rpm - you will need the tar and spec files so keep track of them

Warning (medium size).png
You must not do a publican publish between the publican build and making the tar.
publican publish corrupts the htmls

7. Do a koji scratch build of the SRPM for both the next release and rawhide to ensure a clean build

 pushd ~/rpmbuild/SRPMS
 koji build --scratch dist-rawhide fedora-release-notes-x.y.z.fc16.src.rpm
 koji build --scratch dist-f17 fedora-release-notes-x.y.z.fc16.src.rpm
 popd

8. Switch back to the directory created by fedpkg

9. Switch to the branch for the next release

fedpkg switch-branch f17

10. Post the d-p-r produced tar to the repo

fedpkg new-sources somewhere/fedora-release-notes-x.y.z.tar.gz

11. Copy the spec file into the local repo copy

cp somewhere/fedora-release-notes.spec .

12. Add the changed spec file to the commit (fedpkg already added the tar)

git add fedora-release-notes.spec

13. Commit the tar and specfile

git commit -m "yada yada yada"

14. Push the changes up to fp.o

 git push

15. Build the package from the repo

 fedpkg build

16. Create a Bodhi update request

 fedpkg update

17. Repeat steps 5-11 for rawhide. (Note that even though fedpkg new-sources indicates that the sources are already uploaded, you still need to execute the command to indicate that the new sources apply to the rawhide branch.) the rawhide package does not need to go to Bodhi.

18. Watch the progress of the builds on Koji (http://koji.fedoraproject.org/koji/). When complete, log on to Bodhi and request stable.

19. Recruit your friends and neighbors to give the document karma (https://fedoraproject.org/wiki/Giving_a_document_karma)