akuchling: Sherlock Hemlock (Default)
At the math meetup last Tuesday, I was chatting with someone and found we both wanted to learn Haskell. With the addition of a former co-worker of mine, the group has 3 people. Our goal was to read chapters 1 and 2 of the irritatingly-named Learn You a Haskell for Great Good for today, which wasn't a difficult goal. Assuming we keep going and do one chapter a week, we should finish the book in roughly late February.

The past week was a busy one -- two meetups, plus Halloween -- so I spent no time at all on the GnuPG tutorial. Perhaps this coming week it can find time alongside reading the Haskell book.
akuchling: Sherlock Hemlock (Default)
I've been away on two weekend trips, and checking in on the progress of the Privacy Handbook re-licensing. I am not optimistic; the FSF doesn't seem impressed by the need to change the document's license.

I was pointed to an old repository of the Handbook that may pre-date the copyright transfer to the FSF, but this is starting to get increasingly archaic -- do I want to assess the even-more-outdated SGML in this old repository and re-convert it?

Frankly, if I'd just started writing a new GnuPG tutorial back in September, I would probably have finished a first draft at this point. So I'm going to start thinking about the outline for a new GnuPG introduction.

  • Limit conceptual explanation of cryptography to the high-level; don't bother explaining hash functions, symmetric ciphers, etc.
  • Try to avoid suggesting overrides to GnuPG's config; instead, we should trust that GnuPG has sensible defaults.
  • Encourage people to use mailer integration. Don't try to document the various GUIs; just link to them.

Possible outline:
  1. Cryptography and GnuPG concepts.
  2. Generating a key.
  3. Using GnuPG in your e-mail program.
  4. Using GnuPG from the command line. (Possibly make this an appendix?)
  5. Managing your keys.
akuchling: Sherlock Hemlock (Default)
The Privacy Handbook's copyright is held by the FSF, and it's under the GNU Free Documentation License (FDL). The FDL isn't viewed very favorably these days -- using invariant sections means the document is no longer considered "free" under the Debian Free Software Guidelines -- and today the CC family of licenses are more popular than the FDL.

(I think the FDL's complicated DRM and "Invariant section" language make the FDL hard to understand, and don't apply to the common use case for writers. IMHO relatively few people need to have some parts of a document modifiable and other parts invariant; instead people care about the commercial/non-commercial usage of the document as a whole.)

So the Privacy Handbook's license needs to be changed. Werner Koch, the GnuPG maintainer, has now made this request to the FSF. I don't think the FSF responds very quickly -- presumably this decision will have to wait for some committee or the FSF board to decide -- so now we wait.
akuchling: Sherlock Hemlock (Default)
Sunday I worked on translating the Docbook form of the GNU Privacy Handbook to Emacs org-mode. I didn't try to script it or parse the SGML at all, but just copied the original manual.sgml file to manual.org and began whacking
away at it in Emacs, doing search-and-replaces and manual editing to translate between the two markups.

Docbook provides minutely detailed markup. In a code example, you can mark the system prompt by <prompt></prompt> and the user's typing by <userinput>. All these details are discarded by the translation to org-mode, which only offers the basic formatting of emphasis, italic, monospace, and a few other styles.

I'm working on a branch called akuchling-modernize in my new gph repository on github. The next step will be to apply a patch to make various small updates that's been sent to me. The patch is probably old enough that it's slightly out of date, so then I'll start reading through the document
and consider what revisions I want to make. I also need to figure out what to do for a glossary; the Docbook has a <firstterm> element marking the first use of a term. For now I've left them in. I don't know if I should add a glossary section or just link to the new FAQ.
akuchling: Sherlock Hemlock (Default)
About two weeks ago, I had another spasm of activity and wrote a bunch of new entries for the GPG FAQ, both filling in entries that were blank and adding a few that I thought were a good idea. Happily the maintainer accepted my pull request.

The next step will be to request that the new FAQ be posted and replace the outdated FAQ.
akuchling: Sherlock Hemlock (Default)
The existing GnuPG FAQ is very outdated, referring to versions such as 1.0.4 that were released around 2001. Rob Hansen is working on a new FAQ. Today I read through the XML source for the new FAQ, made a bunch of edits and fixes, and filed a pull request. Once that's accepted, the next step will be to write some of the entries that currently only have FIXME.


akuchling: Sherlock Hemlock (Default)

September 2016

2526272829 30 


RSS Atom

Most Popular Tags

Style Credit

Expand Cut Tags

No cut tags
Page generated Sep. 23rd, 2017 03:53 am
Powered by Dreamwidth Studios