From 57e9bbae7d991901c770d9bc3b83b06d43a20d25 Mon Sep 17 00:00:00 2001 From: Thomas Schwinge Date: Sat, 14 May 2011 11:34:38 +0200 Subject: contributing/web_pages/news: Polish some more. --- contributing/web_pages/news.mdwn | 43 +++++------- contributing/web_pages/news/moth_next.mdwn | 44 ++++++++++++ contributing/web_pages/news/news_moth_next.mdwn | 84 ----------------------- contributing/web_pages/news/skeleton.mdwn | 30 ++++---- contributing/web_pages/news/writing_the_moth.mdwn | 42 ++++++++---- 5 files changed, 108 insertions(+), 135 deletions(-) create mode 100644 contributing/web_pages/news/moth_next.mdwn delete mode 100644 contributing/web_pages/news/news_moth_next.mdwn (limited to 'contributing/web_pages') diff --git a/contributing/web_pages/news.mdwn b/contributing/web_pages/news.mdwn index 4edd491a..54fa788d 100644 --- a/contributing/web_pages/news.mdwn +++ b/contributing/web_pages/news.mdwn @@ -1,4 +1,5 @@ -[[!meta copyright="Copyright © 2009, 2010 Free Software Foundation, Inc."]] +[[!meta copyright="Copyright © 2009, 2010, 2011 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 @@ -8,34 +9,28 @@ 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="""How to prepare and publish "a month of the Hurd" for the last +[[!meta title="""How to prepare and publish a "Month of the Hurd" for the last month"""]] -We prepare *A Month of the Hurd* in the file [[contributing/web_pages/news/news_moth_next]]. The idea is +We prepare a *Month of the Hurd* in the file [[moth_next]]. The idea is to record to-be-published changes in that file at they time they arise, and -then publish them en bloc at the end of the month. +then publish them en bloc at the end of the month. There are instructions for +[[writing_the_moth]]. -* At the end of the month: prepare for publishing the news + * At the end of the month: prepare for publishing the MotH, then send the raw + Markdown text to the mailing list, asking for feedback. - Edit the news entry's *meta date* value to the timestamp when the news - entry is [[published|news]]. We have to set that one manually, as - otherwise the timestamp of the news entry file's creation will be taken, - which is (much) earlier, and not what we want. We do not set the *meta - updated* value, as it's correct to update that one upon further - modifications of the news entries. - -* Then send it to the mailing list, include all feedback ... + * ..., and publish. -* ... and publish + $ git mv contributing/web_pages/news/moth_next.mdwn news/YYYY-MM.mdwn - $ git cp contributing/web_pages/news/news_moth_next.mdwn news/yyyy-mm.mdwn - $ git commit -m "Added MotH yyyy-mm" + Edit the news entry's *meta date* value to the timestamp when the news + entry is published. We have to set that one manually, as otherwise the + timestamp of the news entry file's creation will be taken, which is (much) + earlier, and not what we want. We do not set the *meta updated* value, as + it's correct to update that one upon further modifications of the news + entries. + + $ git cp contributing/web_pages/news/skeleton.mdwn contributing/web_pages/news/moth_next.mdwn + $ git commit -m 'MotH YYYY-MM.' $ git push origin master - -## Information for *writing* the Month of the Hurd - -[[!inline -pages="contributing/web_pages/news/*" -show=5 -feeds=no -actions=yes]] diff --git a/contributing/web_pages/news/moth_next.mdwn b/contributing/web_pages/news/moth_next.mdwn new file mode 100644 index 00000000..1d543634 --- /dev/null +++ b/contributing/web_pages/news/moth_next.mdwn @@ -0,0 +1,44 @@ +[[!meta copyright="Copyright © 2011 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]]."]]"""]] + + + + + +A month of the Hurd: *TODO*, *TODO*, and *TODO*. +[[!if test="included()" then="""[[!toggle id=full_news +text="Details."]][[!toggleable id=full_news text="[[!paste id=full_news]]"]]""" +else=" +[[!paste id=full_news]]"]] + +[[!cut id="full_news" text=""" + + + +This month [hurd hacker] [item] + +Also … + +[our hackers] … + +Mainly thanks to … + +Additionally … + +And … + +[reason for contibuting to the Hurd] + + + +"""]] diff --git a/contributing/web_pages/news/news_moth_next.mdwn b/contributing/web_pages/news/news_moth_next.mdwn deleted file mode 100644 index 3d7442ec..00000000 --- a/contributing/web_pages/news/news_moth_next.mdwn +++ /dev/null @@ -1,84 +0,0 @@ -[[!meta copyright="Copyright © 2011 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]]."]]"""]] - - - -*This is just the working draft. When it is finished, remove this line, adapt the meta tags, and copy it to /news/yyyy-mm.mdwn for publication. Then copy skelleton.mdwn to news-moth-next.mdwn (overwrite) to start the next moth. Feel free to add news items below, but know that the news are open to heavy reworking.* - -A month of the Hurd: *TODO*, *TODO* and *TODO*. -[[!if test="included()" then="""[[!toggle id=full_news -text="Details."]][[!toggleable id=full_news text="[[!paste id=full_news]]"]]""" -else=" -[[!paste id=full_news]]"]] - -[[!cut id="full_news" text=""" - - - -> This month [hurd hacker] [item] -> -> Also … -> -> [our hackers] … -> -> Mainly thanks to … -> -> Additionally … -> -> And … -> -> [reason for contibuting to the Hurd] - - - -Watch these places for news: - - * GNU - - * - - * - - * - - * - - * - - * - - Also Git log. - - * () - - * () - - Better use the Git log. - - * - - * Debian - - * - - * - - * Arch Hurd - - * - - * - - * () - -"""]] diff --git a/contributing/web_pages/news/skeleton.mdwn b/contributing/web_pages/news/skeleton.mdwn index 2fe2578a..1d543634 100644 --- a/contributing/web_pages/news/skeleton.mdwn +++ b/contributing/web_pages/news/skeleton.mdwn @@ -13,9 +13,9 @@ Will be set by tschwinge when publishing. [[!meta date="YYYY-MM-DD HH:MM UTC"]] --> - + -A month of the Hurd: *TODO*, *TODO* and *TODO*. +A month of the Hurd: *TODO*, *TODO*, and *TODO*. [[!if test="included()" then="""[[!toggle id=full_news text="Details."]][[!toggleable id=full_news text="[[!paste id=full_news]]"]]""" else=" @@ -25,19 +25,19 @@ else=" -> This month [hurd hacker] [item] -> -> Also … -> -> [our hackers] … -> -> Mainly thanks to … -> -> Additionally … -> -> And … -> -> [reason for contibuting to the Hurd] +This month [hurd hacker] [item] + +Also … + +[our hackers] … + +Mainly thanks to … + +Additionally … + +And … + +[reason for contibuting to the Hurd] diff --git a/contributing/web_pages/news/writing_the_moth.mdwn b/contributing/web_pages/news/writing_the_moth.mdwn index 56f570b2..d6fd03e3 100644 --- a/contributing/web_pages/news/writing_the_moth.mdwn +++ b/contributing/web_pages/news/writing_the_moth.mdwn @@ -1,22 +1,40 @@ -# Short guide to writing the MotH +[[!meta copyright="Copyright © 2010, 2011 Free Software Foundation, Inc."]] -A simple guideline for writing the Month of the Hurd. +[[!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]]."]]"""]] -### individual news items +# Short Guide for Writing the MotH -The basic structure for a news-item is as follows: [person with link] did [task with link to testable code/patch] which brings us further towards [goal] by [short, easily understandable description of the contribution]. -Each news item should show a step towards the mission of the Hurd. From our [[community/weblogs/antrik/hurd-mission-statement|mission_statement]] you can glean the following basic goals: +## Individual News Items -* Better support for day-to-day desktop use (more packages, more stable, more drivers, easier to setup, …). -* More user freedom and possibilities for programs/translators. -* Technical advancement. -* More unique or at least interesting features. -* Attract more developers and/or users. +The basic structure for a news item is as follows: *\[person with](link) did +\[task with}(link to testable code/patch) which brings us further towards +\[[goal]] by [short, easily understandable description of the contribution]*. -The reason for this structure is to resolve the problem that many people think that the Hurd won’t ever be finished by concentrating on the improvements and the steps towards completing our mission - but only once they have actually been done (to avoid showing anything which might become vaporware). +Each news item should show a step towards the mission of the Hurd. From our +[[mission statement|community/weblogs/antrik/hurd-mission-statement]] you can +glean the following basic goals: -### sources for news + * Better support for day-to-day desktop use (more packages, more stable, more + drivers, easier to setup, ...). + * More user freedom and possibilities for programs/translators. + * Technical advancement. + * More unique or at least interesting features. + * Attract more developers and/or users. + +The reason for this structure is to resolve the problem that many people think +that the Hurd won't ever be finished by concentrating on the improvements and +the steps towards completing our mission -- but only once they have actually +been done (to avoid showing anything which might become vaporware). + + +## Sources for News Items Watch these places for news: -- cgit v1.2.3