[Reproducible-commits] [blog] 01/01: explain the basic workflow

[Holger Levsen]

This is an automated email from the git hooks/post-receive script.

holger pushed a commit to branch master
in repository blog.

commit 8d4f91bb9f398d584c58ea70817b46c088dbca54
Author: Holger Levsen <holger at layer-acht.org>
Date:   Wed Apr 13 13:14:07 2016 +0200

    explain the basic workflow
---
 README | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++-------------
 TODO   |  7 ++++---
 2 files changed, 60 insertions(+), 16 deletions(-)

diff --git a/README b/README
index 90c3700..9d38bba 100644
--- a/README
+++ b/README
@@ -1,17 +1,60 @@
 README
 ------
 
-This file should describe the needed steps to publish a weekly issue of the
-Debian Reproducible builds team newsletter.
-
-It is work in progress and will be written as we limp along and get going.
-
-These things need to be explained here:
-	explain the purpose and scope of the newsletter
-		is it a newsletter? :)
-	explain how to use the tools in misc.git to create the basic template
-	explain /home/groups/reproducible/weekly-log.txt
-	explain posts/ and draft/ directories
-		preview at https://reproducible.alioth.debian.org/blog/drafts/
-	explain publishing
+This file should describe the needed steps to publish the weekly reports on
+our blog.
+
+The idea is to inform and update the project and everyone who is curious about
+the progress we are making. Also it highlights this is a team effort and
+credits the many people who help towards our goals.
+
+Basically what need's to be done each week is:
+- do the 9 steps with tool support to create the basic template.mdwn for this
+  week
+- copy this template.mdwn to drafts/$NR.mdwn and ask for review and help on IRC.
+- polish drafts/$NR.mdwn until it's good.
+- git mv drafts/$NR.mdwn posts/
+- publish.
+
+About each of these steps in a bit more detail:
+
+Creating the basic template.mdwn
+--------------------------------
+
+git clone ssh://git.debian.org/git/reproducible/misc.git
+cd reports
+less README
+
+That README describes these steps:
+
+1. Look at packages that became reproducible this week.
+2. Look at all relevant bug reports that have been modified this week.
+3. Look at all uploads for the past week.
+4. Stats for reviews
+5. New and updated issues
+6. Manually reported
+7. Git repositories and custom toolchain
+8. Documentation updates
+9. Left-overs
+
+Read that README and follow those steps as described there.
+
+
+Turning the template into a draft and finishing it
+--------------------------------------------------
+
+Copy this template.mdwn to drafts/$NR.mdwn and ask for review and help on IRC.
+
+Unpublished drafts are available for easy review at at
+https://reproducible.alioth.debian.org/blog/drafts/
+
+Then polish drafts/$NR.mdwn until it's good.
+Then git mv drafts/$NR.mdwn posts/ ; git commit ; git push.
+
+Then publish. This is not automated yet and needs to be done by h01ger
+manually. Which also means that publishing the draft doesn't work except
+when h01ger does this manually.
+
+
+This README is work in progress and will be written as we limp along and get going.
 
diff --git a/TODO b/TODO
index d6b0524..d206e9b 100644
--- a/TODO
+++ b/TODO
@@ -2,7 +2,6 @@
 	add note saying the URL has moved.
 	add a paragraph thanking lunar hugely for his work, everywhere reproducible, but especially running these weekly news so long, well & continously
 
-finish README
 
 link blog in:
 	wiki
@@ -16,9 +15,11 @@ publishing needs to be automated:
 		ikiwiki --setup ~holger/Reproduciblebuildsblog.setup
 	~holger/Reproduciblebuildsblog.setup needs to be moved to /home/groups/reproducible/ first
 	.setup should be part of this git repo
+	update README once this is done
 
-find out how to set meta date header automatically and do so…
-find out how to set tags automatically and in a meaningful way (ie add tags for other projects covered?)
+minor things which need to go into README too:
+	find out how to set meta date header automatically and do so…
+	find out how to set tags automatically and in a meaningful way (ie add tags for other projects covered?)
 
 ikiwiki polishing:
 	use nicer css than current one

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/blog.git