summaryrefslogtreecommitdiff
path: root/contributing
diff options
context:
space:
mode:
Diffstat (limited to 'contributing')
-rw-r--r--contributing/web_pages.mdwn4
-rw-r--r--contributing/web_pages/news.mdwn54
2 files changed, 58 insertions, 0 deletions
diff --git a/contributing/web_pages.mdwn b/contributing/web_pages.mdwn
index f1388bc2..db8ab4d6 100644
--- a/contributing/web_pages.mdwn
+++ b/contributing/web_pages.mdwn
@@ -48,6 +48,10 @@ we do have some simple requests. Please try to match the *tone* of your topics
and edits with the existing topics. If we all pull in the same direction these
pages will be more useful for everyone, especially for our own use.
+### News Items
+
+There are [[more detailed instructions about editing news items|news]].
+
## Staging Area
When you commit changes, either using the web interface or checking them in
diff --git a/contributing/web_pages/news.mdwn b/contributing/web_pages/news.mdwn
new file mode 100644
index 00000000..f365bc79
--- /dev/null
+++ b/contributing/web_pages/news.mdwn
@@ -0,0 +1,54 @@
+[[!meta copyright="Copyright © 2009 Free Software Foundation, Inc."]]
+
+[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
+is included in the section entitled [[GNU Free Documentation
+License|/fdl]]."]]"""]]
+
+[[!meta title="HowTo prepare and publish 'a month of the Hurd' for the next month"]]
+
+We prepare the month of the Hurd in a public git branch (master-news_next) and merge it once we want to publish the news.
+
+For practical work that means, we use the following commands:
+
+* create a local branch for news_next
+
+ git fetch && git checkout -b master-news_next origin/master-news_next
+
+* get the latest version of news_next when you already created a local version of the branch
+
+ git fetch && git checkout master-news_next
+
+Always do check which branch you're on (asterisk in the first column of
+``git branch'''s output), and only then begin to do your changes and
+commit them.
+
+* create a new news entry
+
+ cp news/yyyy-mm-dd.mdwn news/YYYY-MM-DD.mdwn
+ (edit the new file)
+ git add news/YYYY-MM-DD.mdwn
+ git commit -m "Begun the news entry for YYYY-MM-DD."
+
+(just copy the most recent news file)
+
+* check the outgoing changes
+
+ git log --reverse -p -C origin/master-news_next..master-news_next
+
+* push the changes
+
+ git push origin master-news_next:master-news_next
+
+* if push fails, pull and rebase
+
+ git pull --rebase
+
+* publish the news
+
+ git checkout master && git merge master-news_next
+
+That means, for publishing we merge master-news_next into master.