some language cleanup and included some reccomendations

michael guldan 2014-10-14 23:49:35 -07:00
commit bc1ff84ee9
7 changed files with 44 additions and 7 deletions

21
For-Translators.md Normal file

@ -0,0 +1,21 @@
Please follow these suggested guidelines when translating Tilde doc's:
This will sound like gobbledygook if you don't know [[git]], but I'm putting it
here as a placeholder.
I would suggest linking translations to the specific github commit that
they are translating (Just by adding a line with a link to the specific
commit on Github.)
This means that updating translations can be as simple as:
1) Diffing the "current" FAQ from the version linked by the translation to
see what changed.
2) Translating/updating just the parts that changed.
3) Updating the "based on revision LINK" at the top of the translated FAQ
Thus even if things go out of sync it will be very clear what went out of
sync. And it becomes very apparent to a volunteer what needs to be done
next.
This process can be documented more intelligently than I have done here
inside the FAQ itself, in time, if it is adopted.

6
IRC.md

@ -2,6 +2,10 @@ IRC is the Internet Relay Chat.
Some clients:
## `irssi`
## irssi
`/join #tildechat` to get to the general channel.
## your favorite desktop IRC client
Use [[ssh]] and port forwarding to make the connection. This [tutorial from ~agray](http://tilde.club/~agray/pages/port-forward-irc.shtml) gives the details.

@ -3,3 +3,6 @@ You may have been caught off guard while editing and had some random chat messag
`CTRL+L` will reset your view
`mesg n` at the command prompt will turn off chat messages in that window.
If you don't ever want to see wall messages on your screen, put `mesg n`
into your startup file (details of how to do that needed here).

@ -1,3 +1,12 @@
We're working on it.
We're working on it. You'll need a news server to read news, and it's up;
it's `news.tilde.club`.
`slrn` is a newsreader; see http://slrn.sourceforge.net/ for details.
[[slrn]] is a newsreader; see http://slrn.sourceforge.net/ for details.
[[pine]] can read news; this
[http://www.chebucto.ns.ca/Help/News/PineNews.html](tutorial) might help.
You can also read the [FAQ from U Washington](http://www.washington.edu/pine/faq/news.html).
`M-x gnus` in [[emacs]] can read news, but you better know [[emacs]] first before you start.
[[lynx]] reads news, a la `lynx news://news.tilde.club/tilde.general`. It can even post news, but you have to design your own headers.

@ -2,6 +2,6 @@ When you wish upon a star, your dreams come true.
Put your wish here, and someone will work on it.
* [[IRC]] - tutorials
* [[IRC]] - tutorials; using [[ssh]] port forwarding to run desktop clients
* [[wiki]] - self-hosted on tilde.club? maybe use Gollum? (perhaps just clone a copy of the wiki to a place on tilde?)
* [[git]] - good tutorials for the beginner and good recipes for the advanced user

@ -2,4 +2,4 @@
It's pretty handy. [[tmux]] does a similar set of things.
tutorials exist for screen, (but I don't know where they are yet).
a nice [screen tutorial](http://tilde.club/~jonathan/screen/) from ~jonathan will walk you through it.