svn commit: samba-web r306 - in trunk/news: .

[deryck at samba.org]

Author: deryck
Date: 2004-09-03 17:06:13 +0000 (Fri, 03 Sep 2004)
New Revision: 306

WebSVN: http://websvn.samba.org/websvn/changeset.php?rep=samba-web&path=/trunk/news&rev=306&nolog=1

Log:

Add instructions for posting to news.samba.org.
Minor fix to template for clarification.

--deryck

Added:
   trunk/news/README
Modified:
   trunk/news/story_template.html


Changeset:
Added: trunk/news/README
===================================================================
--- trunk/news/README	2004-09-03 14:50:55 UTC (rev 305)
+++ trunk/news/README	2004-09-03 17:06:13 UTC (rev 306)
@@ -0,0 +1,59 @@
+Please consider the following if you need/want to update news.samba.org:
+
+First, the script that updates news.samba.org organizes postings 
+according to the file's mtime.  If you fix a typo or update a link,
+this will modify the mtime and bump the post to the top.  This is 
+not a big deal if you fix it the day of (or a day later) than the 
+original posting.  If, however, you find a minor mistake from three
+weeks ago, just ignore it.  A news site is meant to report items
+in the moment and be frequently updated, so this behavior is acceptable
+to me.  If information is outdated -- say a particular product 
+has moved to a new website or web page -- then we'll create a new 
+story with updated information.  Which brings me to...
+
+Second, everyone is free to update news.samba.org if you feel inclined
+to do so.  Remember, though, that we don't want to endorse any item,
+event, or topic we report.  Think of our 'news' as 'information.'  
+Consider carefully the implications of your post before you commmit.  
+news.samba.org is meant to be our public relations portal as well as
+a news/information portal.  If in doubt, submit your item to me --
+either via email or via </samba/news/submit.html> -- and I'll make
+the call.
+
+Finally, I imagine that some of you may want to use news.samba.org to
+update the Samba community on progress or aspects of your own work.  
+This is an acceptable and worthwhile use of our news site.  You certainly
+shouldn't feel compelled to post, as many (if not all) may never want to, 
+but if you need space for a mini-article or journal entry to work out
+some ideas in a public space -- without the immediate feedback of our
+mailing lists -- then feel free.  
+
+POSTING INSTRUCTIONS
+
+All you need do is create a story file with a .html extension, "my_story.html"
+for example, and commit it through svn to the appropriate directory.
+Make sure the topic of your story fits the directory where you post it.
+
+"story template" is a template provided in </samba/news> to ensure 
+that each story follows the same format.  Open the template and replace
+the lines in all caps with your information.  One thing important to 
+note is that the <a> tag surrounding the story title must contain the
+story's filename without the .html extension.  This is how links are
+handled.  So from our example above:
+
+---- saved as "my_story.html" in /samba/news/team/ --------------
+
+<h3><a name="my_story">This Is My Story</a></h3>
+
+<div class="article">
+    <p>And my story text goes here, always surrounding each paragraph
+in a full set of p tags.</p>
+    <p>Because xhtml doesn't like to leave tags hanging.</p>
+</div>
+
+-----------------------------------------------------------------
+
+Again, use </samba/news/story_template.html> as a guide.  Or if you
+don't want to be bothered, send items to <deryck (at) samba (dot) org> 
+or submit through </samba/news/submit.html>.
+ 

Modified: trunk/news/story_template.html
===================================================================
--- trunk/news/story_template.html	2004-09-03 14:50:55 UTC (rev 305)
+++ trunk/news/story_template.html	2004-09-03 17:06:13 UTC (rev 306)
@@ -1,5 +1,7 @@
-    <h3><a>TITLE_GOES_HERE</a></h3> 
+    <h3><a name="FILENAME_MINUS_.HTML">TITLE_GOES_HERE</a></h3> 
         
-    <div class="article">STORY_GOES_HERE</div>
+    <div class="article">
+    <p>STORY_TEXT_GOES_HERE</p>
+    </div>