From 52c23a392c4d2620187d3ecb13b05a4a8f93d4fe Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Tue, 24 Jun 2014 11:19:42 +0100 Subject: Add redirect to new docs path --- docs/getting_started.md | 1 + 1 file changed, 1 insertion(+) (limited to 'docs/getting_started.md') diff --git a/docs/getting_started.md b/docs/getting_started.md index 88e5723f7..5c5a7437d 100644 --- a/docs/getting_started.md +++ b/docs/getting_started.md @@ -1,6 +1,7 @@ --- layout: page title: Getting started +redirect_from: /getting_started/ --- # Getting started with Alaveteli -- cgit v1.2.3 From 498564b3dc0daca7012789529e021c8d6c44e38e Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Thu, 3 Jul 2014 13:47:29 +0100 Subject: Add wheezy to supported OS list. Don't privilege squeeze as the recommended install anymore. --- docs/getting_started.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) (limited to 'docs/getting_started.md') diff --git a/docs/getting_started.md b/docs/getting_started.md index 5c5a7437d..615d7e818 100644 --- a/docs/getting_started.md +++ b/docs/getting_started.md @@ -108,12 +108,13 @@ You'll need to find a tech person who knows about hosting websites using Apache and Linux. They don't need to know Ruby on Rails, but it would be a huge advantage if they do. -You'll also need to source a server. You should ask your tech person to help -with this. The minimum spec for running a low traffic website is 512MB RAM and -a 20GB disk. 2GB RAM would be ideal. We recommend Debian Squeeze 64-bit as the -operating system, though any sort of Linux should do. Rackspace offer suitable -cloud servers, which start out at around $25 / month. Then your tech person -should follow the [installation documentation]({{ site.baseurl }}docs/installing/). +You'll also need to source a server. You should ask your tech person to +help with this. The minimum spec for running a low traffic website is +512MB RAM and a 20GB disk. 2GB RAM would be ideal. We recommend the +latest Debian Wheezy (7) or Squeeze (6) 64-bit or Ubuntu precise (12.04) +as the operating system. Rackspace offer suitable cloud servers, which +start out at around $25 / month. Then your tech person should follow the +[installation documentation]({{ site.baseurl }}docs/installing/). Alternatively, you could use Amazon Web Services. This has the added advantage that you can use our preconfigured [Alaveteli EC2 -- cgit v1.2.3 From a0281f2888e4ef325ee29143a4ea05e8d214fdb6 Mon Sep 17 00:00:00 2001 From: Dave Whiteland Date: Wed, 9 Jul 2014 18:22:31 +0100 Subject: linkify mailinator in Getting Started guide --- docs/getting_started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting_started.md') diff --git a/docs/getting_started.md b/docs/getting_started.md index 615d7e818..eddcf78a6 100644 --- a/docs/getting_started.md +++ b/docs/getting_started.md @@ -141,7 +141,7 @@ can see what requests look like to them. When trying things out, you need to wear several hats -- as a site administrator, an ordinary site user, and as a public authority. This can get confusing with several email addresses, so one quick and easy way to manage -this is to use a throwaway email service like http://mailinator.com. +this is to use a throwaway email service like [Mailinator](http://mailinator.com). -- cgit v1.2.3 From cc8ffe62deb242212c55ad1886c41e1a6b087e5c Mon Sep 17 00:00:00 2001 From: Gareth Rees Date: Thu, 8 Jan 2015 16:50:54 +0000 Subject: Update gh-pages blog URLs to mysociety.org Migrating blog to https://www.mysociety.org/category/alaveteli/ --- docs/getting_started.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/getting_started.md') diff --git a/docs/getting_started.md b/docs/getting_started.md index eddcf78a6..30a24a33b 100644 --- a/docs/getting_started.md +++ b/docs/getting_started.md @@ -29,7 +29,7 @@ available time. You can get a feeling for how things might turn out by reading [how an Alaveteli was set up in -Spain]({{ site.baseurl }}2012/04/16/a-right-to-know-site-for-spain/) +Spain](https://www.mysociety.org/2012/04/16/a-right-to-know-site-for-spain/) (remember that this was with an experienced developer in charge). You will also need to think about how you will run the website; a successful Alaveteli requires lots of ongoing effort to moderate and publicise (see Step 6 and Step @@ -158,7 +158,7 @@ If you email possible supporters asking for help, in addition to helping make your job easier, it will also help you identify eager people who might be interested in helping you maintain and run the website. We have written [a blog post about -this]({{ site.baseurl }}2011/07/29/you-need-volunteers-to-make-your-website-work/). +this](https://www.mysociety.org/2011/07/29/you-need-volunteers-to-make-your-website-work/). The admin interface includes a page where you can upload a CSV file (that's a file containing comma-separated values) to create or edit authorities. CSV is a @@ -347,7 +347,7 @@ This will be easier to do with a small team of people sharing jobs. Hopefully you have been lucky enough to get funding to pay people to do these tasks. However, you are also likely to have to rely on volunteers. We've written [a blog post about the importance of -volunteers]({{ site.baseurl }}2011/07/29/you-need-volunteers-to-make-your-website-work/), which you should read. +volunteers](https://www.mysociety.org/2011/07/29/you-need-volunteers-to-make-your-website-work/), which you should read. You'll need to set up a group email address for all the people who will manage the website. All site user queries will go here, as will automatic -- cgit v1.2.3 From a2047fd69cd524c71c2f9212e2315e6d7333bb03 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Fri, 6 Feb 2015 11:45:22 +0000 Subject: Move the details of the help pages to the theming guide. --- docs/getting_started.md | 13 ++----------- 1 file changed, 2 insertions(+), 11 deletions(-) (limited to 'docs/getting_started.md') diff --git a/docs/getting_started.md b/docs/getting_started.md index 30a24a33b..1529046c8 100644 --- a/docs/getting_started.md +++ b/docs/getting_started.md @@ -216,17 +216,8 @@ often less. But complicated workflows might take a bit longer. The default help pages in Alaveteli are taken from WhatDoTheyKnow, and are therefore relevant only to the UK. You should take these pages as inspiration, -but review their content with a view to your jurisdiction. The important pages -to translate are: - -* [About](https://github.com/mysociety/alaveteli/blob/master/app/views/help/about.rhtml): why the website exists, why it works, etc -* [contact](https://github.com/mysociety/alaveteli/blob/master/app/views/help/contact.rhtml): how to get in touch -* [credits](https://github.com/mysociety/alaveteli/blob/master/app/views/help/credits.rhtml): who is involved in the site. Importantly, includes a section on how users can help the project. -* [officers](https://github.com/mysociety/alaveteli/blob/master/app/views/help/officers.rhtml): information for the officers who deal with FOI at authorities. They get a link to this page in emails that the site sends them. -* [privacy](https://github.com/mysociety/alaveteli/blob/master/app/views/help/privacy.rhtml): privacy policy, plus information making it clear that requests are going to appear on the internet. Let users know if they are allowed to use pseudonyms in your jurisdiction. -* [requesting](https://github.com/mysociety/alaveteli/blob/master/app/views/help/requesting.rhtml): the main help page about making requests. How it works, how to decide who to write to, what they can expect in terms of responses, how to make appeals, etc. -* [unhappy](https://github.com/mysociety/alaveteli/blob/master/app/views/help/unhappy.rhtml): users are taken to this page after a request that has been somehow unsuccessful (e.g. the request has been refused, or the authority is insisting on a postal request). The page should encourage them to keep going, e.g. by starting a new request or addressing it to a different body. -* [why email](https://github.com/mysociety/alaveteli/blob/master/app/views/help/_why_they_should_reply_by_email.rhtml): a snippet of information that explains why users should insist on replies by email. This is displayed next to requests that have "gone postal". +but review their content with a view to your jurisdiction. See [the documentation on Alaveteli's themes]({{ site.baseurl }}docs/customising/themes/#customising-the-help-pages) for details +on which pages are important, and what content they need to have. The help pages contain some HTML. Your tech person should be able to advise on this. -- cgit v1.2.3 From af8d108e972a176c9ecf19d4176d0fb6d7b7cb8e Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Thu, 12 Mar 2015 17:34:54 +0000 Subject: Add Transifex to glossary. --- docs/getting_started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting_started.md') diff --git a/docs/getting_started.md b/docs/getting_started.md index 1529046c8..3ea67c818 100644 --- a/docs/getting_started.md +++ b/docs/getting_started.md @@ -276,7 +276,7 @@ spreadsheet. The help pages need to have one copy saved for each language; your tech person will put them in the right place. The web interface translations are managed and collaborated via a website -called Transifex. This website allows teams of translators to collaborate in +called Transifex. This website allows teams of translators to collaborate in one place, using a fairly easy interface. The Alaveteli page on Transifex is at -- cgit v1.2.3