Much of the publishing process is automated:

Write:

  * Develop stories in "content.wiki". The file is (almost) an
    instance of the HWN data type, defined in utils/publish.hs (if you
    want to understand the 'almost', look at the 'tweak' function in
    utils/publish.hs).
  * Urls are in [http://a.b.c/ text] wiki format.

  * You can use the planethaskell, gmane, and quotes tools (all in
    util) to help you gather material.  Read the source of each tool
    for usage and examples; also, when running each tool you can type
    '?' to see a list of available commands.  For now, these tools do
    not modify content.wiki directly; each generates a file suitable
    for pasting into content.wiki.  See utils/README for more detailed
    information.

  * Preview the issues with "make" which dumps rendered .txt, .tex,
    .html and .wiki files in the top level dir.  "make show" will
    render the issue and then open the .html file in w3m.

When complete:

  * Don't forget to write an editorial (if desired)

  * Check urls: urlcheck *.html

  * Generate: ./publish -p

    which moves the .html, .tex, .wiki and .pdf versions into the
    archives/ (suitable for email and sequence.complete.org).

    This also runs the spell checker, which requires aspell installed.
    The issue number will be extracted (and then incremented) from
    'issue' (with -p)

  * The date comes from the current date.

Publish:
  * Html:
      + upload archives/yyyymmdd.html to sequence.complete.org (you
      must already have an account, and need special privileges to
      post the HWN, talk to John Goerzen (CosmicRay))
        - log in
        - Create content > Story
	- use a title like "Haskell Weekly News: Month day, year"
	- choose "Haskell Weekly News" from Categories list
	- choose "General News" from Type list
	- paste archives/yyyymmdd.html into the body field (the xclip
          utility can help with this)
	- under "Input format", choose "Full unfiltered HTML"
	- under "URL path settings", enter "hwn/yyyymmdd" (without the
          quotes)
	- under "Publishing options", select "Published" and "Promoted
          to front page"

  * If desired, email summary and url to lwn@lwn.net (I, byorgey,
    almost never did this, but apparently it used to be done
    regularly)

        The October 31, 2006 edition of the 
        <a href="http://sequence.complete.org/hwn/20061031">Haskell Weekly News</a>
        is online. This week we see a number of community documentation
        and maintenance efforts, and the appearance of indexed data
        types in GHC.

  * Email: 

        + archives/yyyymmdd.txt to haskell@haskell.org and
        haskell-cafe@haskell.org

	+ be sure to send in a plain text format, don't use
	mime/alternative parts (careful, some mailers do this
	automatically without your knowledge)

  * For good issues, post url to programming.reddit.com, suggested
    title: "Haskell Weekly News: headline summary".  In practice, Don
    Stewart will do this for you so no need to trouble yourself. =)

Finally, record and push:
  * darcs whatsnew -sl
  * darcs add archives/yyyymmdd.*
  * darcs record -a -m 'Issue XXX'  
  * darcs push -a