From 4bd2c48f7f1f75d71b3eaed73e3893a2b42b0fee Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 4 Apr 2016 14:59:27 +0100 Subject: Make code customization commented out examples. Rather than having them be live code. --- lib/config/custom-routes.rb | 4 +- lib/controller_patches.rb | 19 ++++---- lib/customstates.rb | 50 ++++++++++++++-------- lib/model_patches.rb | 16 ++++--- lib/views/general/mycontroller.html.erb | 7 --- lib/views/help/about.es.html.erb | 8 ---- lib/views/help/help_out.html.erb | 9 ---- lib/views/outgoing_mailer/initial_request.text.erb | 15 ------- 8 files changed, 54 insertions(+), 74 deletions(-) delete mode 100644 lib/views/general/mycontroller.html.erb delete mode 100644 lib/views/help/about.es.html.erb delete mode 100644 lib/views/help/help_out.html.erb delete mode 100644 lib/views/outgoing_mailer/initial_request.text.erb (limited to 'lib') diff --git a/lib/config/custom-routes.rb b/lib/config/custom-routes.rb index 5aeb7c2..589154a 100644 --- a/lib/config/custom-routes.rb +++ b/lib/config/custom-routes.rb @@ -2,7 +2,7 @@ Rails.application.routes.draw do # brand new controller example - match '/mycontroller' => 'general#mycontroller' + # match '/mycontroller' => 'general#mycontroller' # Additional help page example - match '/help/help_out' => 'help#help_out' + # match '/help/help_out' => 'help#help_out' end diff --git a/lib/controller_patches.rb b/lib/controller_patches.rb index 9959f86..6923062 100644 --- a/lib/controller_patches.rb +++ b/lib/controller_patches.rb @@ -6,13 +6,14 @@ # Rails.configuration.to_prepare do # Example adding an instance variable to the frontpage controller - GeneralController.class_eval do - def mycontroller - @say_something = "Greetings friend" - end - end - HelpController.class_eval do - def help_out - end - end + # GeneralController.class_eval do + # def mycontroller + # @say_something = "Greetings friend" + # end + # end + # Example adding a new action to an existing controller + # HelpController.class_eval do + # def help_out + # end + # end end diff --git a/lib/customstates.rb b/lib/customstates.rb index c09eb8c..73a1bfa 100644 --- a/lib/customstates.rb +++ b/lib/customstates.rb @@ -1,5 +1,5 @@ -# See `doc/THEMES.md` for more explanation of this file -# This example adds a "transferred" state to requests. +# See `http://alaveteli.org/docs/customising/themes/#customising-the-request-states` +# for more explanation of this file module InfoRequestCustomStates @@ -19,32 +19,48 @@ module InfoRequestCustomStates end # Mixin methods for InfoRequest - module ClassMethods + module ClassMethods + + # Return the name of a custom status. + # Example of how to add a custom status: + # def theme_display_status(status) + # if status == 'transferred' + # _("Transferred.") + # else + # raise _("unknown status ") + status + # end + # end def theme_display_status(status) - if status == 'transferred' - _("Transferred.") - else - raise _("unknown status ") + status - end + raise _("unknown status ") + status end + # Return the list of custom statuses added by the theme. + # Example of how to add a custom status: + # def theme_extra_states + # return ['transferred'] + # end def theme_extra_states - return ['transferred'] + return [] end + end end module RequestControllerCustomStates + # `theme_describe_state` is called after the core describe_state code. + # It should end by raising an error if the status is unknown. + # Example of how to add a custom status: + # def theme_describe_state(info_request) + # if info_request.calculate_status == 'transferred' + # flash[:notice] = _("Authority has transferred your request to a different public body.") + # redirect_to request_url(@info_request) + # else + # raise "unknown calculate_status " + info_request.calculate_status + # end + # end def theme_describe_state(info_request) - # called after the core describe_state code. It should - # end by raising an error if the status is unknown - if info_request.calculate_status == 'transferred' - flash[:notice] = _("Authority has transferred your request to a different public body.") - redirect_to request_url(@info_request) - else - raise "unknown calculate_status " + info_request.calculate_status - end + raise "unknown calculate_status " + info_request.calculate_status end end diff --git a/lib/model_patches.rb b/lib/model_patches.rb index 8abd4e8..1564dc4 100644 --- a/lib/model_patches.rb +++ b/lib/model_patches.rb @@ -5,11 +5,13 @@ # See http://stackoverflow.com/questions/7072758/plugin-not-reloading-in-development-mode # Rails.configuration.to_prepare do - OutgoingMessage.class_eval do - # Add intro paragraph to new request template - def default_letter - return nil if self.message_type == 'followup' - #"If you uncomment this line, this text will appear as default text in every message" - end - end + + # Example of adding a default text to each message + # OutgoingMessage.class_eval do + # # Add intro paragraph to new request template + # def default_letter + # return nil if self.message_type == 'followup' + # "If you uncomment this line, this text will appear as default text in every message" + # end + # end end diff --git a/lib/views/general/mycontroller.html.erb b/lib/views/general/mycontroller.html.erb deleted file mode 100644 index ad642d3..0000000 --- a/lib/views/general/mycontroller.html.erb +++ /dev/null @@ -1,7 +0,0 @@ -<% @title = "My new controller" %> - -

My new controller

- -

This is a view of a controller that does almost nothing, except output the words <%= @say_something %>

- - diff --git a/lib/views/help/about.es.html.erb b/lib/views/help/about.es.html.erb deleted file mode 100644 index 9588249..0000000 --- a/lib/views/help/about.es.html.erb +++ /dev/null @@ -1,8 +0,0 @@ -<% @title = "Sobre" %> -<%#-*- coding: utf8 -*-%> -<%= render :partial => 'sidebar' %> - -
-

¡Bonjiorno amis!

-

Esta sito tu aidare a faire los requestio

-
diff --git a/lib/views/help/help_out.html.erb b/lib/views/help/help_out.html.erb deleted file mode 100644 index 6fadca4..0000000 --- a/lib/views/help/help_out.html.erb +++ /dev/null @@ -1,9 +0,0 @@ -<% @title = "Help out" %> - -<%= render :partial => 'sidebar' %> -
-

Help us!

- -

This is a custom "help out" page, showing how you can add new pages to Alaveteli from within a theme.

-
- diff --git a/lib/views/outgoing_mailer/initial_request.text.erb b/lib/views/outgoing_mailer/initial_request.text.erb deleted file mode 100644 index f7878ac..0000000 --- a/lib/views/outgoing_mailer/initial_request.text.erb +++ /dev/null @@ -1,15 +0,0 @@ -<%= raw @outgoing_message.body.strip %> - -------------------------------------------------------------------- - -<%= _('This is an FOI request done via the {{site_name}} website. This footer has been overriden by the sample Alaveteli theme.', :site_name => site_name) %> - -<%= _('Please use this email address for all replies to this request:')%> -<%= @info_request.incoming_email %> - -<%= _('Is {{email_address}} the wrong address for {{type_of_request}} requests to {{public_body_name}}? If so, please contact us using this form:', :email_address => @info_request.public_body.request_email, :type_of_request => @info_request.law_used_human(:full), :public_body_name => @info_request.public_body.name)%> -<%= new_change_request_url(:body => @info_request.public_body.url_name) %> - -<%= render :partial => 'followup_footer' %> - -------------------------------------------------------------------- -- cgit v1.2.3 From 8ccab37ebc69e0e729b0b1748378006a811f4071 Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Mon, 4 Apr 2016 15:05:20 +0100 Subject: Convert to two-space indentation. --- lib/alavetelitheme.rb | 34 +++++++-------- lib/config/custom-routes.rb | 8 ++-- lib/controller_patches.rb | 22 +++++----- lib/customstates.rb | 100 ++++++++++++++++++++++---------------------- lib/model_patches.rb | 16 +++---- lib/patch_mailer_paths.rb | 8 ++-- 6 files changed, 94 insertions(+), 94 deletions(-) (limited to 'lib') diff --git a/lib/alavetelitheme.rb b/lib/alavetelitheme.rb index c8611d5..c245617 100644 --- a/lib/alavetelitheme.rb +++ b/lib/alavetelitheme.rb @@ -3,15 +3,15 @@ theme_name.gsub!('-', '_') THEME_NAME = theme_name class ActionController::Base - # The following prepends the path of the current theme's views to - # the "filter_path" that Rails searches when deciding which - # template to use for a view. It does so by creating a method - # uniquely named for this theme. - path_function_name = "set_view_paths_for_#{THEME_NAME}" - before_filter path_function_name.to_sym - send :define_method, path_function_name do - self.prepend_view_path File.join(File.dirname(__FILE__), "views") - end + # The following prepends the path of the current theme's views to + # the "filter_path" that Rails searches when deciding which + # template to use for a view. It does so by creating a method + # uniquely named for this theme. + path_function_name = "set_view_paths_for_#{THEME_NAME}" + before_filter path_function_name.to_sym + send :define_method, path_function_name do + self.prepend_view_path File.join(File.dirname(__FILE__), "views") + end end # In order to have the theme lib/ folder ahead of the main app one, @@ -27,7 +27,7 @@ end for patch in ['controller_patches.rb', 'model_patches.rb', 'patch_mailer_paths.rb'] - require File.expand_path "../#{patch}", __FILE__ + require File.expand_path "../#{patch}", __FILE__ end # Note you should rename the file at "config/custom-routes.rb" to @@ -36,19 +36,19 @@ $alaveteli_route_extensions << 'custom-routes.rb' # Prepend the asset directories in this theme to the asset path: ['stylesheets', 'images', 'javascripts'].each do |asset_type| - theme_asset_path = File.join(File.dirname(__FILE__), - '..', - 'assets', - asset_type) - Rails.application.config.assets.paths.unshift theme_asset_path + theme_asset_path = File.join(File.dirname(__FILE__), + '..', + 'assets', + asset_type) + Rails.application.config.assets.paths.unshift theme_asset_path end # Tell FastGettext about the theme's translations: look in the theme's # locale-theme directory for a translation in the first place, and if # it isn't found, look in the Alaveteli locale directory next: repos = [ - FastGettext::TranslationRepository.build('app', :path=>File.join(File.dirname(__FILE__), '..', 'locale-theme'), :type => :po), - FastGettext::TranslationRepository.build('app', :path=>'locale', :type => :po) + FastGettext::TranslationRepository.build('app', :path=>File.join(File.dirname(__FILE__), '..', 'locale-theme'), :type => :po), + FastGettext::TranslationRepository.build('app', :path=>'locale', :type => :po) ] FastGettext.add_text_domain 'app', :type=>:chain, :chain=>repos FastGettext.default_text_domain = 'app' diff --git a/lib/config/custom-routes.rb b/lib/config/custom-routes.rb index 589154a..6d4cda4 100644 --- a/lib/config/custom-routes.rb +++ b/lib/config/custom-routes.rb @@ -1,8 +1,8 @@ # Here you can override or add to the pages in the core website Rails.application.routes.draw do - # brand new controller example - # match '/mycontroller' => 'general#mycontroller' - # Additional help page example - # match '/help/help_out' => 'help#help_out' + # brand new controller example + # match '/mycontroller' => 'general#mycontroller' + # Additional help page example + # match '/help/help_out' => 'help#help_out' end diff --git a/lib/controller_patches.rb b/lib/controller_patches.rb index 6923062..5c48e70 100644 --- a/lib/controller_patches.rb +++ b/lib/controller_patches.rb @@ -5,15 +5,15 @@ # See http://stackoverflow.com/questions/7072758/plugin-not-reloading-in-development-mode # Rails.configuration.to_prepare do - # Example adding an instance variable to the frontpage controller - # GeneralController.class_eval do - # def mycontroller - # @say_something = "Greetings friend" - # end - # end - # Example adding a new action to an existing controller - # HelpController.class_eval do - # def help_out - # end - # end + # Example adding an instance variable to the frontpage controller + # GeneralController.class_eval do + # def mycontroller + # @say_something = "Greetings friend" + # end + # end + # Example adding a new action to an existing controller + # HelpController.class_eval do + # def help_out + # end + # end end diff --git a/lib/customstates.rb b/lib/customstates.rb index 73a1bfa..d801c92 100644 --- a/lib/customstates.rb +++ b/lib/customstates.rb @@ -3,64 +3,64 @@ module InfoRequestCustomStates - def self.included(base) - base.extend(ClassMethods) - end - - # Work out what the situation of the request is. In addition to - # values of self.described_state, in base Alaveteli can return - # these (calculated) values: - # waiting_classification - # waiting_response_overdue - # waiting_response_very_overdue - def theme_calculate_status - # just fall back to the core calculation - return self.base_calculate_status - end + def self.included(base) + base.extend(ClassMethods) + end - # Mixin methods for InfoRequest - module ClassMethods + # Work out what the situation of the request is. In addition to + # values of self.described_state, in base Alaveteli can return + # these (calculated) values: + # waiting_classification + # waiting_response_overdue + # waiting_response_very_overdue + def theme_calculate_status + # just fall back to the core calculation + return self.base_calculate_status + end - # Return the name of a custom status. - # Example of how to add a custom status: - # def theme_display_status(status) - # if status == 'transferred' - # _("Transferred.") - # else - # raise _("unknown status ") + status - # end - # end - def theme_display_status(status) - raise _("unknown status ") + status - end + # Mixin methods for InfoRequest + module ClassMethods - # Return the list of custom statuses added by the theme. - # Example of how to add a custom status: - # def theme_extra_states - # return ['transferred'] - # end - def theme_extra_states - return [] - end + # Return the name of a custom status. + # Example of how to add a custom status: + # def theme_display_status(status) + # if status == 'transferred' + # _("Transferred.") + # else + # raise _("unknown status ") + status + # end + # end + def theme_display_status(status) + raise _("unknown status ") + status + end + # Return the list of custom statuses added by the theme. + # Example of how to add a custom status: + # def theme_extra_states + # return ['transferred'] + # end + def theme_extra_states + return [] end + + end end module RequestControllerCustomStates - # `theme_describe_state` is called after the core describe_state code. - # It should end by raising an error if the status is unknown. - # Example of how to add a custom status: - # def theme_describe_state(info_request) - # if info_request.calculate_status == 'transferred' - # flash[:notice] = _("Authority has transferred your request to a different public body.") - # redirect_to request_url(@info_request) - # else - # raise "unknown calculate_status " + info_request.calculate_status - # end - # end - def theme_describe_state(info_request) - raise "unknown calculate_status " + info_request.calculate_status - end + # `theme_describe_state` is called after the core describe_state code. + # It should end by raising an error if the status is unknown. + # Example of how to add a custom status: + # def theme_describe_state(info_request) + # if info_request.calculate_status == 'transferred' + # flash[:notice] = _("Authority has transferred your request to a different public body.") + # redirect_to request_url(@info_request) + # else + # raise "unknown calculate_status " + info_request.calculate_status + # end + # end + def theme_describe_state(info_request) + raise "unknown calculate_status " + info_request.calculate_status + end end diff --git a/lib/model_patches.rb b/lib/model_patches.rb index 1564dc4..7f3b4de 100644 --- a/lib/model_patches.rb +++ b/lib/model_patches.rb @@ -6,12 +6,12 @@ # Rails.configuration.to_prepare do - # Example of adding a default text to each message - # OutgoingMessage.class_eval do - # # Add intro paragraph to new request template - # def default_letter - # return nil if self.message_type == 'followup' - # "If you uncomment this line, this text will appear as default text in every message" - # end - # end + # Example of adding a default text to each message + # OutgoingMessage.class_eval do + # # Add intro paragraph to new request template + # def default_letter + # return nil if self.message_type == 'followup' + # "If you uncomment this line, this text will appear as default text in every message" + # end + # end end diff --git a/lib/patch_mailer_paths.rb b/lib/patch_mailer_paths.rb index 7a524fa..99da10a 100644 --- a/lib/patch_mailer_paths.rb +++ b/lib/patch_mailer_paths.rb @@ -3,8 +3,8 @@ # See http://stackoverflow.com/questions/7072758/plugin-not-reloading-in-development-mode # Rails.configuration.to_prepare do - # Override mailer templates with theme ones. Note doing this in a before_filter, - # as we do with the controller paths, doesn't seem to have any effect when - # running in production - ActionMailer::Base.prepend_view_path File.join(File.dirname(__FILE__), "views") + # Override mailer templates with theme ones. Note doing this in a before_filter, + # as we do with the controller paths, doesn't seem to have any effect when + # running in production + ActionMailer::Base.prepend_view_path File.join(File.dirname(__FILE__), "views") end -- cgit v1.2.3 From 62b5ac9fab138f17bfe8cfa7654af75ca341f55b Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Wed, 6 Apr 2016 15:48:11 +0100 Subject: Add generic example version of each required help page. --- lib/views/help/_sidebar.html.erb | 37 +- .../help/_why_they_should_reply_by_email.html.erb | 2 +- lib/views/help/about.html.erb | 49 +- lib/views/help/alaveteli.html.erb | 30 ++ lib/views/help/api.html.erb | 167 +++--- lib/views/help/contact.html.erb | 100 ++++ lib/views/help/credits.html.erb | 125 ++--- lib/views/help/officers.html.erb | 403 +++++++-------- lib/views/help/privacy.html.erb | 361 +++++++------ lib/views/help/requesting.html.erb | 565 ++++++++++----------- lib/views/help/unhappy.html.erb | 116 +++++ 11 files changed, 1080 insertions(+), 875 deletions(-) create mode 100644 lib/views/help/alaveteli.html.erb create mode 100644 lib/views/help/contact.html.erb create mode 100644 lib/views/help/unhappy.html.erb (limited to 'lib') diff --git a/lib/views/help/_sidebar.html.erb b/lib/views/help/_sidebar.html.erb index 958fd78..e92ea43 100644 --- a/lib/views/help/_sidebar.html.erb +++ b/lib/views/help/_sidebar.html.erb @@ -1,21 +1,18 @@ -
-

Help pages

-
    -
  • <%= link_to_unless_current "Introduction", help_about_path %>
    • -
  • <%= link_to_unless_current "Making requests", help_requesting_path %>
    • -
  • <%= link_to_unless_current "Your privacy", help_privacy_path %>
    • -
  • <%= link_to_unless_current "FOI officers", help_officers_path %>
    • -
  • <%= link_to_unless_current "About the software", help_alaveteli_path %>
    • -
  • <%= link_to_unless_current "Credits", help_credits_path %>
    • -
  • <%= link_to_unless_current "Programmers API", help_api_path %>
    • -
  • <%= link_to_unless_current "Help us", help_general_path(:action => 'help_out') %>
    • -
  • <%= link_to_unless_current "Advanced search", advanced_search_path %>
    • -
- -

Contact us

-

If your question isn't answered here, or you just wanted to let us know - something about the site, contact us. -

-
- +
+

Help pages

+
    +
  • <%= link_to_unless_current "Introduction", help_about_path %>
    • +
  • <%= link_to_unless_current "Making requests", help_requesting_path %>
    • +
  • <%= link_to_unless_current "Your privacy", help_privacy_path %>
    • +
  • <%= link_to_unless_current "FOI officers", help_officers_path %>
    • +
  • <%= link_to_unless_current "About the software", help_alaveteli_path %>
    • +
  • <%= link_to_unless_current "Credits", help_credits_path %>
    • +
  • <%= link_to_unless_current "Programmers API", help_api_path %>
    • +
  • <%= link_to_unless_current "Advanced search", advanced_search_path %>
    • +
+

Contact us

+

If your question isn't answered here, or you just wanted to let us know + something about the site, contact us. +

+
\ No newline at end of file diff --git a/lib/views/help/_why_they_should_reply_by_email.html.erb b/lib/views/help/_why_they_should_reply_by_email.html.erb index faaa2b2..1dfdcae 100644 --- a/lib/views/help/_why_they_should_reply_by_email.html.erb +++ b/lib/views/help/_why_they_should_reply_by_email.html.erb @@ -1,3 +1,3 @@ -The law, the Ministry of Justice and the Information Commissioner all say that an email is sufficient (more details). +The laws says that an email is sufficient (more details). At the bottom of this page, write a reply to the authority explaining this to them. diff --git a/lib/views/help/about.html.erb b/lib/views/help/about.html.erb index a2b5ef2..36120f1 100644 --- a/lib/views/help/about.html.erb +++ b/lib/views/help/about.html.erb @@ -2,8 +2,51 @@ <%= render :partial => 'sidebar' %> -
-

Introduction to <%= site_name %> #

This is a custom "about" page

-
+
+

Introduction to <%= site_name %> #

+
+
What is <%= site_name %> for? #
+
To help you find out inside information about what the government + is doing. +
+
How does the site work? #
+
You choose the public authority that you would like information from, then + write a brief note describing what you want to know. We then send your request + to the public authority. Any response they make is automatically published on the + website for you and anyone else to find and read. +
+ +
Why would I bother to do this? #
+
You pay taxes, and then government does things with the money. All sorts of + things that affect your life, from healthcare through to national defence. Some + it does badly, some it does well. The more we find out about how government + works, the better able we are to make suggestions to improve the things that + are done badly, and to celebrate the things that are done well. +
+ +
Why would the public authority bother to reply? #
+
Under Freedom of Information (FOI) law, they have to respond. The response + will either contain the information you want, or give a valid legal reason why + it must be kept confidential. +
+ +
Who makes <%= site_name %> ? #
+
<%= site_name %> runs on Alaveteli, which was created and run by mySociety, + and was initially funded by the JRSST Charitable Trust. mySociety is a project of the + registered charity UK Citizens Online Democracy. + If you like what we're doing, then you can + make a donation. +
+ +
How can I keep up with news about <%= site_name %>?#
+
We have a blog<% if !MySociety::Config.get('TWITTER_USERNAME', '').empty? %> and a >twitter feed<% end %>. +
+ +
+ +

Next, read about making requests -->

+ + +
\ No newline at end of file diff --git a/lib/views/help/alaveteli.html.erb b/lib/views/help/alaveteli.html.erb new file mode 100644 index 0000000..ebf659e --- /dev/null +++ b/lib/views/help/alaveteli.html.erb @@ -0,0 +1,30 @@ +<% @title = "Making requests" %> + +<%= render :partial => 'sidebar' %> +
+ <% if params[:country_name] %> +

<%= _("Would you like to see a website like this in your country?") %>

+ <% else %> +

Powered by Alaveteli

+ <% end %> +

This website is powered by Alaveteli. Alaveteli is free software + for making Freedom of Information requests. It can easily be + translated into any language, and customised for variations of FOI + law.

+ +

The development of Alaveteli is sponsored and supported by a + number of foundations and charities who are interested in + transparency across the world.

+ +

If you would like to set up an Alaveteli website in your own + country, we can help. You will need a few days to get the site + configured and ready to use, and will then have to spend at least an + hour a week moderating and managing the site (more for busy + websites).

+ +

Read more on the Alaveteli + website, or drop us an + email.

+ + +
\ No newline at end of file diff --git a/lib/views/help/api.html.erb b/lib/views/help/api.html.erb index 5f27c2e..2055fbf 100644 --- a/lib/views/help/api.html.erb +++ b/lib/views/help/api.html.erb @@ -1,83 +1,90 @@ -<% @title = "Application Programming Interface - API" %> +<% @title = "About our API" %> <%= render :partial => 'sidebar' %> -
-

<%=@title %>

- -

Introduction

- -

This page explains how programmers can make other websites and software -interact with <%= site_name %> via an "API". -

- -

<%= site_name %> does not have a full API yet, but we are gradually adding -lots of things that are similar in use to an API as they are requested. -

- -
- -

1. Linking to new requests

- -

To encourage your users to make requests to a particular public authority, use URLs of the form: -<%= link_to new_request_to_body_url(:url_name => "liverpool_city_council") , new_request_to_body_url(:url_name => "liverpool_city_council") %>. -These are the parameters you can add to those URLs, either in the URL or from a form. - -

    -
  • title - default summary of the new request.
    • -
  • default_letter - default text of the body of the letter. The salutation (Dear...) and signoff (Yours...) are wrapped round this.
    • -
  • body - as an alternative to default_letter, this sets the default entire text of the request, so you can customise the salutation and signoff.
    • -
  • tags - space separated list of tags, so you can find and link up any requests made later, e.g. openlylocal spending_id:12345. The : indicates it is a machine tag. The values of machine tags may also include colons, useful for URIs. -
- -
- -

2. RSS (actually, Atom) feeds

- -

There are Atom feeds on most pages which list FOI requests, which you can -use to get updates and links in XML format. Find the URL of the Atom feed in -one of these ways: -

    -
  • Look for the RSS feed links.
    • -
  • Examine the <link rel="alternate" type="application/atom+xml"> tag in the head of the HTML.
    • -
  • Add /feed to the start of another URL. -
- -

In particular, even complicated search queries have Atom feeds. -You can do all sorts of things with them, such as query by authority, by file -type, by date range, or by status. See the advanced search -tips for details. - -

- -

3. JSON structured data

- -

Quite a few pages have JSON versions, which let you download information about -objects in a structured form. Find them by: -

    -
  • Adding .json to the end of the URL.
    • -
  • Look for the <link rel="alternate" type="application/json"> tag in the head of the HTML.
    • -
-

- -

Requests, users and authorities all have JSON versions containing basic -information about them. Every Atom feed has a JSON equivalent, containing -information about the list of events in the feed. -

- -
-

4. Spreadsheet of all authorities

- -

-A spreadsheet file listing every body in <%= site_name %> is available: -<%= link_to "all-authorities.csv", all_public_bodies_csv_url() %> -

- -
- -

Please contact us if you need an API feature that isn't there yet. It's -very much a work in progress, and we do add things when people ask us to.

- - - -
+
+

<%=@title %>

+
+
Introduction
+
+

This page explains how programmers can make other websites and software + interact with <%= site_name %> via an "API". +

+ +

<%= site_name %> does not have a full API yet, but we are gradually adding + lots of things that are similar in use to an API as they are requested. +

+
+ +
Linking to new requests
+
+

To encourage your users to make links to a particular public authority, use URLs of the form + <%= link_to new_request_to_body_path(:url_name => "liverpool_city_council") , new_request_to_body_path(:url_name => "liverpool_city_council") %>. + These are the parameters you can add to those URLs, either in the URL or from a form. +

+
    +
  • title - default summary of the new request.
    • +
  • default_letter - default text of the body of the letter. The salutation (Dear...) and signoff (Yours...) are wrapped round this.
    • +
  • body - as an alternative to default_letter, this sets the default entire text of the request, so you can customise the salutation and signoff.
    • +
  • tags - space separated list of tags, so you can find and link up any requests made later, e.g. openlylocal spending_id:12345. The : indicates it is a machine tag. The values of machine tags may also include colons, useful for URIs. +
+
+ +
RSS (actually, Atom) feeds
+
+

There are Atom feeds on most pages which list FOI requests, which you can + use to get updates and links in XML format. Find the URL of the Atom feed in + one of these ways: +

+
    +
  • Look for the <%= image_tag "feed-16.png", :alt => "RSS icon" %> RSS feed links.
    • +
  • Examine the <link rel="alternate" type="application/atom+xml"> tag in the head of the HTML.
    • +
  • Add /feed to the start of another URL. +
+ +

In particular, even complicated search queries have Atom feeds. + You can do all sorts of things with them, such as query by authority, by file + type, by date range, or by status. See the advanced search + tips for details. +

+
+ +
JSON structured data
+
+

Quite a few pages have JSON versions, which let you download information about + objects in a structured form. Find them by: +

+
    +
  • Adding .json to the end of the URL.
    • +
  • Look for the <link rel="alternate" type="application/json"> tag in the head of the HTML.
    • +
+ +

Requests, users and authorities all have JSON versions containing basic + information about them. Every Atom feed has a JSON equivalent, containing + information about the list of events in the feed. +

+
+ +
Spreadsheet of all authorities
+
+

+ A spreadsheet file listing every body in <%= site_name %> is available: + <%= link_to "all-authorities.csv", all_public_bodies_csv_path %> +

+ +
+ + +
5. Write API
+
+

+ The write API is designed to be used by authorities to create their own requests in the system. The API is currently used by mySociety's FOI Register software to support using Alaveteli as a disclosure log for all FOI activity at a particular public body. More technical information about the write API is available on the Alaveteli wiki. +

+
+
+ +

Please contact us if you need an API feature that isn't there yet. It's + very much a work in progress, and we do add things when people ask us to.

+ + +
\ No newline at end of file diff --git a/lib/views/help/contact.html.erb b/lib/views/help/contact.html.erb new file mode 100644 index 0000000..5f467fe --- /dev/null +++ b/lib/views/help/contact.html.erb @@ -0,0 +1,100 @@ +<% @title = "Contact us" %> + +<%= foi_error_messages_for :contact %> + +

<%= @title %>

+ +
+ + <% if !flash[:notice] %> +

Contact an authority to get official information

+
    +
  • Go here to make a request, in public, for information + from public authorities.
    • + +
  • + Asking for private information about yourself? + Please read our + help page. +
    • +
+ + <% end %> + +

Contact the <%= site_name %> team

+ <% if !flash[:notice] %> +
    +
  • + Please read the help page first, as it may + answer your question quicker. +
    • + +
  • We'd love to hear how you've found using this site. + Either fill in this form, or send an email to <%=@contact_email%> +
    • + +
  • We are a charity and not part of the + Government.
    • +
+ <% end %> +
+ +<%= form_for :contact do |f| %> + + <% if not @user %> +

+ + <%= f.text_field :name, :size => 20 %> + (or <%= link_to "sign in", signin_path(:r => request.fullpath) %>) +

+ +

+ + <%= f.text_field :email, :size => 20 %> +

+ <% end %> + +

+ + <%= f.text_field :subject, :size => 50 %> +

+ +

+ + <%= f.text_area :message, :rows => 10, :cols => 60 %> +

+ +

+ <%= f.label :comment, 'Do not fill in this field' %> + <%= f.text_field :comment %> +

+ + <% if !@last_request.nil? %> +

+ + <%=request_link(@last_request) %> + <%= submit_tag "remove", :name => 'remove' %> +

+ <% end %> + <% if !@last_body.nil? %> +

+ + <%=public_body_link(@last_body) %> + <%= submit_tag "remove", :name => 'remove' %> +

+ <% end %> + +

+ We can only help you with technical problems, or questions + about Freedom of Information. +

+ + +
+ <%= hidden_field_tag(:submitted_contact_form, 1) %> + <%= submit_tag "Send message to the charity", :disable_with => "Sending..." %> + <-- we run this site, not the Government! +
+ +<% end %> \ No newline at end of file diff --git a/lib/views/help/credits.html.erb b/lib/views/help/credits.html.erb index bc493bc..dc034c3 100644 --- a/lib/views/help/credits.html.erb +++ b/lib/views/help/credits.html.erb @@ -1,92 +1,59 @@ -<% @title = "Credit where credit is due" %> +<% @title = "Credit where credit’s due" %> <%= render :partial => 'sidebar' %> -
+
+

<%= @title %> #

-

<%= @title%> #

+

Alaveteli, the software that powers <%= site_name %>, is a project of mySociety, a UK organisation. mySociety builds websites that empower citizens to hold authorities to account. And this is one of those sites.

- -
Which people made <%= site_name %>? #
-
Oh, nearly everyone (and maybe you too)! -
    -
  • - Heather Brooke - (vampy!) has - been pushing the idea of a UK FOI archive for years now. -
    • -
  • - Both Phil Rodgers and Francis Irving - entered it in a mySociety competition for ideas for public interest websites to build. -
    • -
  • - It won, - and then Chris Lightfoot (RIP :() - thought up the wheeze of intercepting email responses to requests and - automatically publishing them. -
    • -
  • - Tom Steinberg got the cash to pay for the site from - a dead chocolate mogul (thank you!) ... -
    • -
  • - ... so that Francis Irving, Angie Ahl, Tommy Martin, Louise Crow, Matthew Somerville - and Tom Steinberg could do the complex mixture of design and coding to build - what you see today. -
    • -
  • - Thanks particularly to Julian Todd (great blog!), - Francis Davey, and Etienne Pollard for using the site early on and giving - feedback (and/or legal advice!), and also to all our other users and - testers. -
    • -
  • - The amazing team of volunteers who run the site, answer your support - emails, maintain the database of public authorities and - so much more. - Thanks to John Cross, Ben Harris, Adam McGreggor, Alex Skene, - Richard Taylor. -
    • -
  • - Volunteers who have provided patches to the code - thanks Peter Collingbourne - and Tony Bowden. -
    • -
  • - Everyone who has helped look up FOI email addresses. -
    • -
  • - We couldn't do any of this without those - crazy people who volunteer, - amongst many other things, to do the accounts and fill in our VAT return. -
    • -
  • - Finally, all the officers and servants who have answered the many requests - made through the site. Their diligence, patience and professionalism is - what has actually made the information that you see here. Thank them for - helping make Government more transparent. -
    • -
-You're all stars. +
Development #
+
+ Hearty cheers to Alaveteli’s many contributors.

-
Can I help out? #
+
How to help #
-

Yes please! We're built out of our supporters and volunteers.

-
    -
  • You can make a donation. We're a registered charity.
    • -
  • Help people find successful requests, and monitor performance of authorities, by - playing the categorisation game.
    • -
  • Find out FOI email addresses of authorities that we're missing.
    • -
  • Write a blog post about either <%= site_name %> or an interesting request that you've - found. Post about it on a forum that you frequent. Tell friends about it.
  • If you're - a programmer, get the source code for our parent project, Alaveteli - and tell us about patches we can pull. It's made in Ruby on Rails. -
  • Read more about volunteering with mySociety. -
+
Become a volunteer #
+
+

If you have a passion for transparency, a great deal of patience, and a bit of spare time, consider becoming one of <%= site_name %>'s volunteer admin team. Work includes user support, helping to resolve legal issues, and shaping the site’s direction, and is primarily managed via email.

+

In the first instance, <%= link_to 'get in touch', help_contact_path %>.

+
+ + +
+

mySociety, Alaveteli's parent organisation, is a charity. WhatDoTheyKnow, our most-visited Alaveteli site, costs thousands of pounds each year, for overheads such as servers, maintenance and development.

+ +

Your contributions, however small, really help. Donate here.

+
+ +
Sort things out #
+
+

Admin can be fun! Help people find successful requests, and monitor performance of authorities, by playing the categorisation game.

+ +

Or be a dear, and find out FOI email addresses of authorities that we're missing.

+
+ +
Spread the word #
+
+

We don’t have a massive marketing budget, so word of mouth really helps.

+
    +
  • Write a blog post about <%= site_name %>, or an interesting request that you've found.
    • +
  • Post about the site, and what you can do with it, on a forum that you frequent.
    • +
  • Tell friends about it.
    • +
  • Let your local newspaper or community magazine know how useful we are.
    • +
  • Give a talk.
    • +
  • <%= mail_to 'hello@mysociety.org', 'Ask us for leaflets', :encode => "javascript" %> to leave in your local library or coffee shop.
    • +
+
+
Improve our code #
+
+

Seen something that could work better? If you're a programmer, get the source code for our parent project, Alaveteli and send us a pull request. <%= site_name %> is coded in Ruby on Rails.

+
+
- -
+
\ No newline at end of file diff --git a/lib/views/help/officers.html.erb b/lib/views/help/officers.html.erb index 0a7d208..5a0418f 100644 --- a/lib/views/help/officers.html.erb +++ b/lib/views/help/officers.html.erb @@ -1,247 +1,196 @@ <% @title = "FOI officer questions" %> <%= render :partial => 'sidebar' %> -
- -

<%= @title %> #

- -
- -
I just got here from bottom of an FOI request, what is going on? #
- -

<%= site_name %> is a service run by a charity. It helps ordinary members -of the public make FOI requests, and easily track and share the responses.

- -

The FOI request you received was made by someone using <%= site_name %>. You can -simply reply to the request as you would any other request from an individual. -The only difference is that your response will be automatically published on -the Internet. -

-

If you have privacy or other concerns, please read the answers below. -You might also like to read the introduction to <%= site_name %> to find out more about what -the site does from the point of view of a user. You can also search the -site to find the authority that you work for, and view the status of -any requests made using the site. - -

Finally, we welcome comments and -thoughts from FOI officers, please get in touch. -

-
- -
Why are you publishing responses to FOI requests? #
- -
We think there are lots of benefits. Most importantly it will encourage the -public to be more interested and involved in the work of government. We -also hope that it will reduce the number of duplicate requests on any -subject that a public body will receive. Given that Freedom of Information -responses contain public information, which anybody could easily request -again from the public authority, we think there should be no reason not to -publish it widely. -
- -
Are the people making requests real people? #
- -
Yes. For the purposes of keeping track of responses we use -computer-generated email addresses for each request. However, before -they can send a request, each user must register on the site with a -unique email address that we then verify. You can search this site and -find a page listing all requests that each person has made. -
- -
An email isn't a sufficient address for an FOI request! #
- -
Yes it is. This -letter from the ICO to Rother District Council gives guidance on the matter, specifically -in the context of requests made via <%= site_name %>. -
- -
Aren't you making lots of vexatious requests? #
- -

<%= site_name %> is not making any requests. We are sending requests on -behalf of our users, who are real people making the requests.

-

Look at it like this - if lots of different people made requests from -different Hotmail email addresses, then you would not think that Microsoft were -making vexatious requests. It is exactly the same if lots of requests are made -via <%= site_name %>. Moreover, since all requests are public it is much easier -for you to see if one of our users is making vexatious requests.

-

If that isn't enough for you, the -letter from the ICO to Rother District Council gives some guidance on the matter.

-
- -
I can see a request on <%= site_name %>, but we never got it by email!#
- -

If a request appears on the site, then we have attempted to send it to -the authority by email. Any delivery failure messages will automatically -appear on the site. You can check the address we're using with the "View FOI -email address" link which appears on the page for the authority. Contact us if there is a better address we can -use.

-

Requests are sometimes not delivered because they are quietly removed by -"spam filters" in the IT department of the authority. Authorities can make -sure this doesn't happen by asking their IT departments to "whitelist" -any email from @<%= AlaveteliConfiguration::incoming_email_domain %>. -If you ask us we will resend any request, -and/or give technical details of delivery so an IT department can chase -up what happened to the message. -

-

Finally, you can respond to any request from your web browser, without -needing any email, using the "respond to request" link at the bottom of -each request page. -

- -
How do you calculate the deadline shown on request pages?#
- -
-

The Freedom of Information Act says:

- -

A public authority must comply with section 1(1) promptly and -in any event not later than the twentieth working day following the date of -receipt.

- -

The nerdy detail of exactly how weekends are counted, and what happens if -the request arrives out of office hours, is just that - detail. What matters -here is that the law says authorities must respond promptly.

- -

If you've got a good reason why the request is going to take a while to -process, requesters find it really helpful if you can send a quick email with a -sentence or two saying what is happening.

- -

FOI officers often have to do a lot of hard work to answer -requests, and this is hidden from the public. We think it would help everyone -to have more of that complexity visible.

- -
- -
But really, how do you calculate the deadline?#
- -
- -

Please read the answer to the previous question first. Legally, authorities -must respond promptly to FOI requests. If they fail to do that, -it is best if they show the hard work they are doing by explaining what is -taking the extra time to do. -

- -

That said, <%= site_name %> does show the maximum legal deadline -for response on each request. Here's how we calculate it.

- -
    - -
  • If the day we deliver the request by email is a working day, we count that -as "day zero", even if it was delivered late in the evening. Days end at -midnight. We then count the next working day as "day one", and so on up to -20 working days.
    • - -
  • If the day the request email was delivered was a non-working day, we count -the next working day as "day one". Delivery is delivery, even if it happened on -the weekend. Some authorities disagree with this, our lawyer disagrees with them.
    • - -
  • Requesters are encouraged to mark when they have clarified -their request so the clock resets, but sometimes they get this wrong. If you -see a problem with a particular request, let us know and we'll fix it.
    • -
- -

The date thus calculated is shown on requests with the text "By law, -Liverpool City Council should normally have responded by...". There is only -one case which is not normal, see the next question about -public interest test time extensions. -

- -

Schools are also a special case, which <%= site_name %> displays differently. -

- -
    -
  • Since June 2009, schools have "20 working days -disregarding any working day which is not a school day, or 60 working days, -whichever is first" (FOI (Time for Compliance with Request) Regulations 2009). <%= site_name %> indicates on requests to schools that the 20 day deadline is only -during term time, and shows them as definitely overdue after 60 working days -
    • -
- -

If you're getting really nerdy about all this, read the detailed ICO guidance. -Meanwhile, remember that the law says authorities must respond -promptly. That's really what matters.

- -
- -
How do you reflect time extensions for public interest tests?#
- -
- -

The Freedom of Information Act lets authorities claim an indefinite time -extension when applying a public interest test. Information -Commissioner guidance says that it should only be used in "exceptionally -complex" cases -(FOI Good Practice Guidance No. 4). -<%= site_name %> doesn't specifically handle this case, which is why we use the -phrase "should normally have responded by" when the 20 working day time is -exceeded. -

-

The same guidance says that, even in exceptionally complex cases, no -Freedom of Information request should take more than 40 working days -to answer. <%= site_name %> displays requests which are overdue by that much -with stronger wording to indicate they are definitely late. -

+
+

<%= @title %> #

+ +
+ +
I just got here from bottom of an FOI request, what is going on? #
+ +

<%= site_name %> is a service run by a charity. It helps ordinary members + of the public make FOI requests, and easily track and share the responses.

+ +

The FOI request you received was made by someone using <%= site_name %>. You can + simply reply to the request as you would any other request from an individual. + The only difference is that your response will be automatically published on + the Internet. +

+

If you have privacy or other concerns, please read the answers below. + You might also like to read the introduction to <%= site_name %> to find out more about what + the site does from the point of view of a user. You can also search the + site to find the authority that you work for, and view the status of + any requests made using the site. + +

Finally, we welcome comments and + thoughts from FOI officers, please get in touch. +

+
+ +
Why are you publishing responses to FOI requests? #
+ +
We think there are lots of benefits. Most importantly it will encourage the + public to be more interested and involved in the work of government. We + also hope that it will reduce the number of duplicate requests on any + subject that a public body will receive. Given that Freedom of Information + responses contain public information, which anybody could easily request + again from the public authority, we think there should be no reason not to + publish it widely. +
+ +
Are the people making requests real people? #
+ +
Yes. For the purposes of keeping track of responses we use + computer-generated email addresses for each request. However, before + they can send a request, each user must register on the site with a + unique email address that we then verify. You can search this site and + find a page listing all requests that each person has made. +
+ +
An email isn't a sufficient address for an FOI request! #
-

The Freedom of Information (Scotland) Act does not allow such a public -interest extension. <%= site_name %> would like to see the law changed to either -remove the extension from the UK Act, or to reintroduce an absolute time limit -of 40 working days even with the extension (the House of Lords voted -to remove provision for such a time limit during the initial passage -of the UK Act through Parliament). -

-
+
Yes it is. In the UK, this + letter from the ICO to Rother District Council gives guidance on the matter, specifically + in the context of requests made via WhatDoTheyKnow, a similar site to <%= site_name %>. +
+ +
Aren't you making lots of vexatious requests? #
+ +

<%= site_name %> is not making any requests. We are sending requests on + behalf of our users, who are real people making the requests.

+

Look at it like this - if lots of different people made requests from + different Hotmail email addresses, then you would not think that Microsoft were + making vexatious requests. It is exactly the same if lots of requests are made + via <%= site_name %>. Moreover, since all requests are public it is much easier + for you to see if one of our users is making vexatious requests.

-
How can I send a large file, which won't go by email?#
+ -
Instead of email, you can respond to a request directly from your web -browser, including uploading a file. To do this, choose "respond to request" at -the bottom of the request's page. Contact us if it -is too big for even that (more than, say, 50Mb). -
+
I can see a request on <%= site_name %>, but we never got it by email!#
+ +

If a request appears on the site, then we have attempted to send it to + the authority by email. Any delivery failure messages will automatically + appear on the site. You can check the address we're using with the "View FOI + email address" link which appears on the page for the authority. Contact us if there is a better address we can + use.

+

Requests are sometimes not delivered because they are quietly removed by + "spam filters" in the IT department of the authority. Authorities can make + sure this doesn't happen by asking their IT departments to "whitelist" + any email from @<%= AlaveteliConfiguration::incoming_email_domain %>. + If you ask us we will resend any request, + and/or give technical details of delivery so an IT department can chase + up what happened to the message. +

+

Finally, you can respond to any request from your web browser, without + needing any email, using the "respond to request" link at the bottom of + each request page. +

+
+ +
How do you calculate the deadline shown on request pages?#
-
Why do you publish the names of civil servants and the text of emails? #
+
+ +

The Freedom of Information Act says:

+ +

A public authority must comply with section 1(1) promptly and + in any event not later than the twentieth working day following the date of + receipt.

+ +

The nerdy detail of exactly how weekends are counted, and what happens if + the request arrives out of office hours, is just that - detail. What matters + here is that the law says authorities must respond promptly.

+ +

If you've got a good reason why the request is going to take a while to + process, requesters find it really helpful if you can send a quick email with a + sentence or two saying what is happening.

+ +

FOI officers often have to do a lot of hard work to answer + requests, and this is hidden from the public. We think it would help everyone + to have more of that complexity visible.

+ +
+ +
But really, how do you calculate the deadline?#
+ +
+ +

Please read the answer to the previous question first. Legally, authorities + must respond promptly to FOI requests. If they fail to do that, + it is best if they show the hard work they are doing by explaining what is + taking the extra time to do. +

-
We consider what officers or servants do in the course of their employment -to be public information. We will only remove content in exceptional -circumstances, see our take down policy. -
+

That said, <%= site_name %> does show the maximum legal deadline + for response on each request. Here's how we calculate it.

+ +
    -
    Do you publish email addresses or mobile phone numbers? #
    +
  • If the day we deliver the request by email is a working day, we count that + as "day zero", even if it was delivered late in the evening. Days end at + midnight. We then count the next working day as "day one", and so on up to + <%= AlaveteliConfiguration::reply_late_after_days %> working days.
    • + +
  • If the day the request email was delivered was a non-working day, we count + the next working day as "day one". Delivery is delivery, even if it happened on + the weekend. Some authorities disagree with this, our lawyer disagrees with them.
    • -

    To prevent spam, we automatically remove most emails and some mobile numbers from -responses to requests. Please contact us if we've -missed one. -For technical reasons we don't always remove them from attachments, such as certain PDFs.

    -

    If you need to know what an address was that we've removed, please get in touch with us. Occasionally, an email address -forms an important part of a response and we will post it up in an obscured -form in an annotation. -

    +
  • Requesters are encouraged to mark when they have clarified + their request so the clock resets, but sometimes they get this wrong. If you + see a problem with a particular request, let us know and we'll fix it.
    • +
+ +

The date thus calculated is shown on requests with the text "By law, + Liverpool City Council should normally have responded by...". +

- + -
Our Freedom of Information law is "applicant blind", so anyone in the -world can request the same document and get a copy of it. +
How can I send a large file, which won't go by email?#
-If you think our making a document available on the internet infringes your -copyright, you may contact us and ask us -to take it down. However, to save tax payers' money by preventing duplicate -requests, and for good public relations, we'd advise you not to do that. - +
Instead of email, you can respond to a request directly from your web + browser, including uploading a file. To do this, choose "respond to request" at + the bottom of the request's page. Contact us if it + is too big for even that (more than, say, 50Mb). +
-
+
Why do you publish the names of civil servants and the text of emails? #
+ +
We consider what officers or servants do in the course of their employment + to be public information. We will only remove content in exceptional + circumstances, see our take down policy. +
+
Do you publish email addresses or mobile phone numbers? #
- - -

If you haven't already, read the introduction --> -
Otherwise, the credits or the programmers API --> +

To prevent spam, we automatically remove most emails and some mobile numbers from + responses to requests. Please contact us if we've + missed one. + For technical reasons we don't always remove them from attachments, such as certain PDFs.

+

If you need to know what an address was that we've removed, please get in touch with us. Occasionally, an email address + forms an important part of a response and we will post it up in an obscured + form in an annotation. +

- + +
Our Freedom of Information law is "applicant blind", so anyone in the + world can request the same document and get a copy of it. -
+ If you think our making a document available on the internet infringes your + copyright, you may contact us and ask us + to take it down. However, to save tax payers' money by preventing duplicate + requests, and for good public relations, we'd advise you not to do that. + + + + +

If you haven't already, read the introduction --> +
Otherwise, the credits or the programmers API --> + +

+ \ No newline at end of file diff --git a/lib/views/help/privacy.html.erb b/lib/views/help/privacy.html.erb index 6f190ee..9330d5c 100644 --- a/lib/views/help/privacy.html.erb +++ b/lib/views/help/privacy.html.erb @@ -2,185 +2,182 @@ <%= render :partial => 'sidebar' %> -
-

<%= @title %> #

- -
- -
Who gets to see my email address? #
- -

We will not disclose your email address to anyone unless we are obliged to by law, -or you ask us to. This includes the public authority that you are sending a -request to. They only get to see an email address -@<%= AlaveteliConfiguration::incoming_email_domain %> which is specific to that request.

-

If you send a message to another user on the site, then it will reveal your -email address to them. You will be told that this is going to happen.

-
- -
Will you send nasty, brutish spam to my email address? #
-
Nope. After you sign up to <%= site_name %> we will only send you emails -relating to a request you made, an email alert that you have signed up for, -or for other reasons that you specifically authorise. We will never give or -sell your email addresses to anyone else, unless we are obliged to by law, or -you ask us to. -
- -
Why will my name and my request appear publicly on the site? #
- -
-

We publish your request on the Internet so that anybody can read it and -make use of the information that you have found. We do not normally delete -requests (more details). -

-

-Your name is tangled up with your request, so has to be published as well. -It is only fair, as we're going to publish the name of the civil servant who -writes the response to your request. Using your real name also helps people -get in touch with you to assist you with your research or to campaign with you. -

-

By law, you must use your real name for the request to be a valid Freedom of -Information request. See the next question for alternatives if you do not want -to publish your full name. -

-
- -
Can I make an FOI request using a pseudonym? #
- - -
-

Technically, you must use your real name for your request to be a valid Freedom of Information request in law. See this -guidance from the Information Commissioner (January 2009). -

- -

However, the same guidance also says it is good practice for the public -authority to still consider a request made using an obvious pseudonym. -You should refer to this if a public authority refuses a request because you -used a pseudonym.

- -

Be careful though, even if the authority follows this good practice, the -pseudonym will probably make it impossible for you to complain to the -Information Commissioner later about the handling of your request. -

- -

There are several good alternatives to using a pseudonym.

- -
    -
  • Use a different form of your name. The guidance says -that "Mr Arthur Thomas Roberts" can make a valid request as "Arthur Roberts", -"A. T. Roberts", or "Mr Roberts", but not as "Arthur" or "A.T.R.". -
    • -
  • Women may use their maiden name.
    • -
  • In most cases, you may use any name by which you are "widely known and/or -is regularly used". -
  • Use the name of an organisation, the name of a company, the trading name of -a company, or the trading name of a sole trader. -
  • Ask someone else to make the request on your behalf. -
  • You may, if you are really stuck, ask us to make the request on -your behalf. Please contact us with -a good reason why you cannot make the request yourself and cannot -ask a friend to. We don't have the resources to do this for everyone. -
- -

Please do not try to impersonate someone else.

- -
- -
They've asked for my postal address! #
- -
-

If a public authority asks you for your full, physical address, reply to them saying -that section 8.1.b of the FOI Act asks for an "address for correspondence", -and that the email address you are using is sufficient. -

-

-The Ministry of Justice has guidance -on this – -"As well as hard copy written correspondence, requests that are -transmitted electronically (for example, in emails) are acceptable -... If a request is received by email and no postal address is given, the email -address should be treated as the return address." - -

-

As if that isn't enough, the Information Commissioner's -Hints for Practitioners say -"Any correspondence could include a request for information. If it is written (this includes e-mail), legible, gives the name of the applicant, an address for reply (which could be electronic), and includes a description of the information required, then it will fall within the scope of the legislation." -

-
- -
No no, they need a postal address to send a paper response! #
- -
-

If an authority only has a paper copy of the information that you want, -they may ask you for a postal address. To start with, try persuading them -to scan in the documents for you. You can even offer to gift them a scanner, which in that particular case -embarrassed the authority into finding one they had already.

- -

If that doesn't work, and you want to provide your postal address privately -in order to receive the documents, mark your request as "They are going to reply by post", and it will -give you an email address to use for that purpose.

-
- -
Can you delete my requests, or alter my name? #
- -
- -

<%= site_name %> is a permanent, public archive of Freedom of -Information requests. Even though you may not find the response to -a request useful any more, it may be of interest to others. For this -reason, we will not delete requests. -

- -

Under exceptional circumstances we may remove or change your name -on the website, see the next question. -Similarly, we may also remove other personal information. -

- -

If you're worried about this before you make your request, -see the section on pseudonyms.

- -
- -
Can you take down personal information about me? #
- -
- -

If you see any personal information about you on the site which you'd like -us to remove or hide, then please let us know. -Specify exactly what information you believe to be problematic and why, and -where it appears on the site.

- -

If it is sensitive personal information that has been accidentally -posted, then we will usually remove it. Normally we will only consider -requests to remove personal information which come from the individual -concerned, but for sensitive information we would appreciate anyone -pointing out anything they see.

- -

We consider that there is a strong public interest in -retaining the names of officers or servants of public authorities. We will only -remove such names in exceptional circumstances, such as where the disclosure of -a name and position of employment would substantially risk an individual's -safety. If you are such an official and you wish to have your name removed for -such an urgent reason, you must supply us with a request to do so from your -line manager. This request must demonstrate that a risk has been perceived -which outweighs the public interest, and must demonstrate that efforts have -been made to conceal the name on the organisation's own website.

- -

For all other requests we apply a public interest test to decide -whether information should be removed. - Section 32 -of the Data Protection Act 1998 permits us to do this, as the material we -publish is journalistic. We cannot easily edit many types of attachments (such -as PDFs, or Microsoft Word or Excel files), so we will usually ask -that authorities resend these with the personal information removed.

- -
- - -
- -

Learn more from the help for FOI officers --> - -

- - -
+
+

<%= @title %> #

+
+ +
Who gets to see my email address? #
+ +

We will not disclose your email address to anyone unless we are obliged to by law, + or you ask us to. This includes the public authority that you are sending a + request to. They only get to see an email address + @<%= AlaveteliConfiguration::incoming_email_domain %> which is specific to that request.

+

If you send a message to another user on the site, then it will reveal your + email address to them. You will be told that this is going to happen.

+
+ +
Will you send nasty, brutish spam to my email address? #
+
Nope. After you sign up to <%= site_name %> we will only send you emails + relating to a request you made, an email alert that you have signed up for, + or for other reasons that you specifically authorise. We will never give or + sell your email addresses to anyone else, unless we are obliged to by law, or + you ask us to. +
+ +
Why will my name and my request appear publicly on the site? #
+ +
+

We publish your request on the Internet so that anybody can read it and + make use of the information that you have found. We do not normally delete + requests (more details). +

+

+ Your name is tangled up with your request, so has to be published as well. + It is only fair, as we're going to publish the name of the civil servant who + writes the response to your request. Using your real name also helps people + get in touch with you to assist you with your research or to campaign with you. +

+

By law, you must use your real name for the request to be a valid Freedom of + Information request. See the next question for alternatives if you do not want + to publish your full name. +

+
+ +
Can I make an FOI request using a pseudonym? #
+ + +
+

Technically, you must use your real name for your request to be a valid Freedom of Information request in UK law. See this + guidance from the Information Commissioner (January 2009). +

+ +

However, the same guidance also says it is good practice for the public + authority to still consider a request made using an obvious pseudonym. + You should refer to this if a public authority refuses a request because you + used a pseudonym.

+ +

Be careful though, even if the authority follows this good practice, the + pseudonym will probably make it impossible for you to complain to the + Information Commissioner later about the handling of your request. +

+ +

There are several good alternatives to using a pseudonym.

+ +
    +
  • Use a different form of your name. The guidance says + that "Mr Arthur Thomas Roberts" can make a valid request as "Arthur Roberts", + "A. T. Roberts", or "Mr Roberts", but not as "Arthur" or "A.T.R.". +
    • +
  • Women may use their maiden name.
    • +
  • In most cases, you may use any name by which you are "widely known and/or + is regularly used".
    • +
  • Use the name of an organisation, the name of a company, the trading name of + a company, or the trading name of a sole trader.
    • +
  • Ask someone else to make the request on your behalf.
    • +
  • You may, if you are really stuck, ask us to make the request on + your behalf. Please contact us with + a good reason why you cannot make the request yourself and cannot + ask a friend to. We don't have the resources to do this for everyone.
    • +
+ +

Please do not try to impersonate someone else.

+ +
+ +
They've asked for my postal address! #
+ +
+

If a public authority asks you for your full, physical address, reply to them saying + that section 8.1.b of the FOI Act asks for an "address for correspondence", + and that the email address you are using is sufficient. +

+

+ The Ministry of Justice has guidance + on this – + "As well as hard copy written correspondence, requests that are + transmitted electronically (for example, in emails) are acceptable + ... If a request is received by email and no postal address is given, the email + address should be treated as the return address." + +

+

As if that isn't enough, the Information Commissioner's + Hints for Practitioners say + "Any correspondence could include a request for information. If it is written (this includes e-mail), legible, gives the name of the applicant, an address for reply (which could be electronic), and includes a description of the information required, then it will fall within the scope of the legislation." +

+
+ +
No no, they need a postal address to send a paper response! #
+ +
+

If an authority only has a paper copy of the information that you want, + they may ask you for a postal address. To start with, try persuading them + to scan in the documents for you. You can even offer to gift them a scanner, which in that particular case + embarrassed the authority into finding one they had already.

+ +

If that doesn't work, and you want to provide your postal address privately + in order to receive the documents, mark your request as "They are going to reply by post", and it will + give you an email address to use for that purpose.

+
+ +
Can you delete my requests, or alter my name? #
+ +
+ +

<%= site_name %> is a permanent, public archive of Freedom of + Information requests. Even though you may not find the response to + a request useful any more, it may be of interest to others. For this + reason, we will not delete requests. +

+ +

Under exceptional circumstances we may remove or change your name + on the website, see the next question. + Similarly, we may also remove other personal information. +

+ +

If you're worried about this before you make your request, + see the section on pseudonyms.

+ +
+ +
Can you take down personal information about me? #
+ +
+ +

If you see any personal information about you on the site which you'd like + us to remove or hide, then please let us know. + Specify exactly what information you believe to be problematic and why, and + where it appears on the site.

+ +

If it is sensitive personal information that has been accidentally + posted, then we will usually remove it. Normally we will only consider + requests to remove personal information which come from the individual + concerned, but for sensitive information we would appreciate anyone + pointing out anything they see.

+ +

We consider that there is a strong public interest in + retaining the names of officers or servants of public authorities. We will only + remove such names in exceptional circumstances, such as where the disclosure of + a name and position of employment would substantially risk an individual's + safety. If you are such an official and you wish to have your name removed for + such an urgent reason, you must supply us with a request to do so from your + line manager. This request must demonstrate that a risk has been perceived + which outweighs the public interest, and must demonstrate that efforts have + been made to conceal the name on the organisation's own website.

+ +

For all other requests we apply a public interest test to decide + whether information should be removed. + Section 32 + of the Data Protection Act 1998 permits us to do this, as the material we + publish is journalistic. We cannot easily edit many types of attachments (such + as PDFs, or Microsoft Word or Excel files), so we will usually ask + that authorities resend these with the personal information removed.

+ +
+ + +
+ +

Learn more from the help for FOI officers --> + +

+
\ No newline at end of file diff --git a/lib/views/help/requesting.html.erb b/lib/views/help/requesting.html.erb index 28e55fd..ca6bff7 100644 --- a/lib/views/help/requesting.html.erb +++ b/lib/views/help/requesting.html.erb @@ -1,286 +1,285 @@ <% @title = "Making requests" %> <%= render :partial => 'sidebar' %> -
- -

<%= @title %> #

-
- -
I'm not sure which authority to make my request to, how can I find out? #
- -
-

It can be hard to untangle government's complicated structured, and work out -who knows the information that you want. Here are a few tips: -

    -
  • Browse or search <%= site_name %> looking for similar requests to yours.
    • -
  • When you've found an authority you think might have the information, use -the "home page" link on the right hand side of their page to check what they do -on their website.
    • -
  • Contact the authority by phone or email to ask if they hold the kind of -information you're after.
    • -
  • Don't worry excessively about getting the right authority. If you get it -wrong, they ought to advise you who to make the request to instead. -
    • -
  • If you've got a thorny case, please contact us for help.
    • -
- -
- - - -
You're missing the public authority that I want to request from! #
- -
-

Please contact us with the name of the public authority and, -if you can find it, their contact email address for Freedom of Information requests. -

-

If you'd like to help add a whole category of public authority to the site, we'd love -to hear from you too. -

- -
- -
Why do you include some authorities that aren't formally subject to FOI?#
- -
-

<%= site_name %> lets you make requests for information to a range of -organisations:

- -
    -
  • Those formally subject to the FOI Act
    • -
  • Those formally subject to the Environmental Regulations (a less well - defined group)
    • -
  • Those which voluntarily comply with the FOI Act
    • -
  • Those which aren't subject to the Act but we think should be, on grounds - such as them having significant public responsibilities. -
    • -
- -

In the last case, we're using the site to lobby for expansion of the -scope of the FOI Act. Even if an organisation is not legally obliged to respond -to an FOI request, they can still do so voluntarily. -

- -
- -
Why must I keep my request focused?#
- -
- -

-Please put in your request only what is needed so that someone can -easily identify what information you are asking for. Please do -not include any of the following: -

- -
    -
  • arguments about your cause
    • -
  • statements that could defame or insult others
    • -
- -

-If you do, we may have to remove your request to avoid problems with -libel law, which is a pain for both you and us. Short, succinct messages -make it easier for authorities to be clear what information you are -requesting, which means you will get a reply more quickly. -

- -

-If you want information to support an argument or campaign, Freedom of -Information is a powerful tool. Although you may not use this site to -run your campaign, we encourage you to use it to get the information you -need. We also encourage to run your campaign elsewhere - one effective -and very easy way is to <%= link_to 'start your own blog', -"http://wordpress.com/"%>. You are welcome to link to your campaign -from this site in an annotation to your request (you can make -annotations after submitting the request). -

- -
- -
Does it cost me anything to make a request?#
- -
- -

Making an FOI request is nearly always free.

- -

Authorities often include unnecessary, scary, boilerplate in -acknowledgement messages saying they "may" charge a fee. Ignore such notices. -They hardly ever will actually charge a fee. If they do, they can only charge you if -you have specifically agreed in advance to pay. More - details from the Information Commissioner. -

- -

Sometimes an authority will refuse your request, saying that the cost -of handling it exceeds £600 (for central government) or £450 (for all other -public authorities). At this point you can refine your -request. e.g. it would be much cheaper for an authority to tell you the amount -spent on marshmallows in the past year than in the past ten years. -

- -
- - - -
How quickly will I get a response? #
- -
-

By law, public authorities must respond promptly to -requests. -

- -

Even if they are not prompt, in nearly all cases they must respond within -20 working days. If you had to clarify your request, or they are a school, -or one or two other cases, then they may have more time -(full details). - -

<%= site_name %> will email you if you don't get a timely response. You can -then send the public authority a message to remind them, and tell them if they -are breaking the law.

- -
- -
What if I never get a response?#
- -
-

There are several things you can do if you never get a response.

-
    -
  • Sometimes there has been a genuine problem and the authority never - received the request. It is worth telephoning the authority and politely - checking that they received the request. It was sent to them by email. -
    • -
  • If they have not received it, the problem is most likely due to - "spam filters". Refer the authority to the measures in the answer - 'I can see a request on <%= site_name %>, but we never got it by email!' - in the FOI officers section of this help. -
    • -
  • If you're still having no luck, then you can ask for an internal review, - and then complain to the Information Commissioner about the authority. - Read our page 'Unhappy about the response you got?'. -
-
- -
What if I'm not satisfied with the response? #
-
If you didn't get the information you asked for, or you didn't get it in time, -then read our page 'Unhappy about the response you got?'. -
- -
It says I can't re-use the information I got!#
-
-

Authorities often add legal boilerplate about the -"Re-Use of Public Sector -Information Regulations 2005", which at first glance implies you may not -be able do anything with the information. -

- -

You can, of course, write articles about the information or summarise it, or -quote parts of it. We also think you should feel free to republish the -information in full, just as we do, even though in theory you might not be -allowed to do so. See our policy on copyright.

- -
- -
Can you tell me more of the nitty gritty about the process of making requests? #
- -
-

Have a look at the -access to official information -pages on the Information Commissioner's website.

- -

If you're requesting information from a Scottish public authority, -the process is very similar. There are differences around time -limits for compliance. -See the Scottish -Information Commissioner's guidance for details.

-
- -
Can I request information about myself? #
- -
-

No. Requests made using <%= site_name %> are public, made under the Freedom of -Information Act, and cannot help you find information about a private -individual.

- -

If you would like to know what information a public -authority holds about yourself, you should make a "Subject Access Request" in -private using Data Protection law. The leaflet "How to access your information" (on the Information Commissioner's -website) explains how to do this.

- -

If you see that somebody has included personal information, perhaps -unwittingly, in a request, please contact us -immediately so we can remove it.

-
- - -
I'd like to keep my request secret! (At least until I publish my story) #
- -

<%= site_name %> is currently only designed for public requests. All -responses that we receive are automatically published on the website for anyone -to read.

-

You should contact the public authority directly if you would like to -make a request in private. If you're interested in buying a system which helps -you manage FOI requests in secret, then contact us. -

-
- -
Why can I only request information about the environment from some authorities? #
- -
-

Some public authorities, such as South East Water, -don't come under the Freedom of Information Act, but do come under another law called -the Environmental Information Regulations (EIR). -

- -

It's a very similar law, so you make a request -to them using <%= site_name %> in just the same way as an FOI request. The only -difference is that on the page where your write you request, it reminds you -that you can only request "environmental information" and tells you what that -means. It is quite broad. -

- -

You can, of course, request environmental information from other -authorities. Just make a Freedom of Information (FOI) request as normal. The -authority has a duty to work out if the Environmental Information Regulations -(EIR) is the more appropriate legislation to reply under. -

-
- -
Can I make the same to request to lots of authorities, e.g. all councils? #
- -
We ask you to first send a test version of your request to a few -authorities. Their responses will help you improve the wording of your request, -so that you get the best information when you send the request to all of -the authorities. There is currently no automated system for sending the request -to the other authorities, you must copy and paste it by hand. - -
- -
I made a request off the site, how do I upload it to the archive?#
- -
<%= site_name %> is an archive of requests made through the site, -and does not try to be an archive of all FOI requests. We'll never support uploading -other requests. For one thing, we wouldn't be able to verify that other -responses actually came from the authority. If this really matters to you, -you can always make the same request again via <%= site_name %>. -
- -
How do you moderate request annotations? #
- -
-

Annotations on <%= site_name %> are to help -people get the information they want, or to give them pointers to places they -can go to help them act on it. We reserve the right to remove anything else. -

-

Endless, political discussions are not allowed. -Post a link to a suitable forum or campaign site elsewhere.

-
- -
- -

Next, read about your privacy --> - -

- -
+
+

<%= @title %> #

+
+ +
I'm not sure which authority to make my request to, how can I find out? #
+ +
+

It can be hard to untangle government's complicated structure, and work out + who holds the information that you want. Here are a few tips: +

+
    +
  • Browse or search <%= site_name %> looking for similar requests to yours.
    • +
  • When you've found an authority you think might have the information, use + the "home page" link on the right hand side of their page to check what they do + on their website.
    • +
  • Contact the authority by phone or email to ask if they hold the kind of + information you're after.
    • +
  • Don't worry excessively about getting the right authority. If you get it + wrong, they ought to advise you who to make the request to instead. +
    • +
  • If you've got a thorny case, please contact us for help.
    • +
+ +
+ + + +
You're missing the public authority that I want to request from! #
+ +
+

Please contact us with the name of the public authority and, + if you can find it, their contact email address for Freedom of Information requests. +

+

If you'd like to help add a whole category of public authority to the site, we'd love + to hear from you too. +

+ +
+ +
Why do you include some authorities that aren't formally subject to FOI?#
+ +
+

<%= site_name %> lets you make requests for information to a range of + organisations:

+ +
    +
  • Those formally subject to the FOI Act
    • +
  • Those formally subject to the Environmental Regulations (a less well + defined group)
    • +
  • Those which voluntarily comply with the FOI Act
    • +
  • Those which aren't subject to the Act but we think should be, on grounds + such as them having significant public responsibilities. +
    • +
+ +

In the last case, we're using the site to lobby for expansion of the + scope of the FOI Act. Even if an organisation is not legally obliged to respond + to an FOI request, they can still do so voluntarily. +

+ +
+ +
Why must I keep my request focused?#
+ +
+ +

+ Please put in your request only what is needed so that someone can + easily identify what information you are asking for. Please do + not include any of the following: +

+ +
    +
  • arguments about your cause
    • +
  • statements that could defame or insult others
    • +
+ +

+ If you do, we may have to remove your request to avoid problems with + libel law, which is a pain for both you and us. Short, succinct messages + make it easier for authorities to be clear what information you are + requesting, which means you will get a reply more quickly. +

+ +

+ If you want information to support an argument or campaign, Freedom of + Information is a powerful tool. Although you may not use this site to + run your campaign, we encourage you to use it to get the information you + need. We also encourage to run your campaign elsewhere - one effective + and very easy way is to <%= link_to 'start your own blog', + "http://wordpress.com/"%>. You are welcome to link to your campaign + from this site in an annotation to your request (you can make + annotations after submitting the request). +

+ +
+ +
Does it cost me anything to make a request?#
+ +
+ +

Making an FOI request is nearly always free.

+ +

Authorities often include unnecessary, scary, boilerplate in + acknowledgement messages saying they "may" charge a fee. Ignore such notices. + They hardly ever will actually charge a fee. If they do, they can only charge you if + you have specifically agreed in advance to pay. More + details from the Information Commissioner. +

+ +

Sometimes an authority will refuse your request, saying that the cost + of handling it exceeds £600 (for central government) or £450 (for all other + public authorities). At this point you can refine your + request. e.g. it would be much cheaper for an authority to tell you the amount + spent on marshmallows in the past year than in the past ten years. +

+ +
+ + + +
How quickly will I get a response? #
+ +
+

By law, public authorities must respond promptly to + requests. +

+ +

Even if they are not prompt, in nearly all cases they must respond within + 20 working days. If you had to clarify your request, or they are a school, + or one or two other cases, then they may have more time + (full details). +

+

<%= site_name %> will email you if you don't get a timely response. You can + then send the public authority a message to remind them, and tell them if they + are breaking the law.

+ +
+ +
What if I never get a response?#
+ +
+

There are several things you can do if you never get a response.

+
    +
  • Sometimes there has been a genuine problem and the authority never + received the request. It is worth telephoning the authority and politely + checking that they received the request. It was sent to them by email. +
    • +
  • If they have not received it, the problem is most likely due to + "spam filters". Refer the authority to the measures in the answer + 'I can see a request on <%= site_name %>, but we never got it by email!' + in the FOI officers section of this help. +
    • +
  • If you're still having no luck, then you can ask for an internal review, + and then complain to the Information Commissioner about the authority. + Read our page 'Unhappy about the response you got?'. +
+
+ +
What if I'm not satisfied with the response? #
+
If you didn't get the information you asked for, or you didn't get it in time, + then read our page 'Unhappy about the response you got?'. +
+ +
It says I can't re-use the information I got!#
+
+

Authorities often add legal boilerplate about the + "Re-Use of Public Sector + Information Regulations 2005", which at first glance implies you may not + be able do anything with the information. +

+ +

You can, of course, write articles about the information or summarise it, or + quote parts of it. We also think you should feel free to republish the + information in full, just as we do, even though in theory you might not be + allowed to do so. See our policy on copyright.

+ +
+ +
Can you tell me more of the nitty gritty about the process of making requests? #
+ +
+

Have a look at the + access to official information + pages on the Information Commissioner's website.

+ +

If you're requesting information from a Scottish public authority, + the process is very similar. There are differences around time + limits for compliance. + See the Scottish + Information Commissioner's guidance for details.

+
+ +
Can I request information about myself? #
+ +
+

No. Requests made using <%= site_name %> are public, made under the Freedom of + Information Act, and cannot help you find information about a private + individual.

+ +

If you would like to know what information a public + authority holds about yourself, you should make a "Subject Access Request" in + private using Data Protection law. The leaflet "How to access your information" (on the Information Commissioner's + website) explains how to do this.

+ +

If you see that somebody has included personal information, perhaps + unwittingly, in a request, please contact us + immediately so we can remove it.

+
+ + +
I'd like to keep my request secret! (At least until I publish my story) #
+ +

<%= site_name %> is currently only designed for public requests. All + responses that we receive are automatically published on the website for anyone + to read.

+

You should contact the public authority directly if you would like to + make a request in private. If you're interested in buying a system which helps + you manage FOI requests in secret, then contact us. +

+
+ +
Why can I only request information about the environment from some authorities? #
+ +
+

Some public authorities, such as South East Water, + don't come under the Freedom of Information Act, but do come under another law called + the Environmental Information Regulations (EIR). +

+ +

It's a very similar law, so you make a request + to them using <%= site_name %> in just the same way as an FOI request. The only + difference is that on the page where you write your request, it reminds you + that you can only request "environmental information" and tells you what that + means. It is quite broad. +

+ +

You can, of course, request environmental information from other + authorities. Just make a Freedom of Information (FOI) request as normal. The + authority has a duty to work out if the Environmental Information Regulations + (EIR) is the more appropriate legislation to reply under. +

+
+ +
Can I make the same to request to lots of authorities, e.g. all councils? #
+ +
We ask you to first send a test version of your request to a few + authorities. Their responses will help you improve the wording of your request, + so that you get the best information when you send the request to all of + the authorities. There is currently no automated system for sending the request + to the other authorities, you must copy and paste it by hand. + +
+ +
I made a request off the site, how do I upload it to the archive?#
+ +
<%= site_name %> is an archive of requests made through the site, + and does not try to be an archive of all FOI requests. We'll never support uploading + other requests. For one thing, we wouldn't be able to verify that other + responses actually came from the authority. If this really matters to you, + you can always make the same request again via <%= site_name %>. +
+ +
How do you moderate request annotations? #
+ +
+

Annotations on <%= site_name %> are to help + people get the information they want, or to give them pointers to places they + can go to help them act on it. We reserve the right to remove anything else. +

+

Endless, political discussions are not allowed. + Post a link to a suitable forum or campaign site elsewhere.

+
+ +
+ +

Next, read about your privacy --> + +

+
\ No newline at end of file diff --git a/lib/views/help/unhappy.html.erb b/lib/views/help/unhappy.html.erb new file mode 100644 index 0000000..6526b0f --- /dev/null +++ b/lib/views/help/unhappy.html.erb @@ -0,0 +1,116 @@ +<% @title = "Unhappy about a Freedom of Information request?" %> + + +<% if @info_request %> +

Unhappy about the response you got + to your request '<%=request_link(@info_request) %>'? +

+<% else %> +

Unhappy about the response you got?

+<% end %> + +

If ...

+ +
    +
  • You didn't get a reply within 20 working days
    • +
  • You did not get all of the information that you requested or
    • +
  • Your request was refused, but without a reason valid under the law
    • +
+ +

... you can

+ +
    +
  1. Ask for an internal review at the public authority.
    2. +
  2. If that doesn't help, complain to the Information Commissioner.
    3. +
  3. Either way, also use other means to answer your question.
    4. +
+ +

1. Asking for an internal review #

+ +

+ <% if @info_request %> + <%= link_to "Request an internal review", new_request_followup_path(:request_id => @info_request.id) + "?internal_review=1#followup", :class => 'link_button_green request-internal-review-action' %> and then write a message asking the authority to review your request. + <% else %> + At the bottom of the relevant request page on <%= site_name %> choose + "request an internal review". Then write a message asking for an internal + review of your request. You may want to include a link to the + request page, to make it clear which request you are talking about. + <% end %> +

+ +

Internal reviews should be quick. If one takes longer than 20 working days + then the authority should write and let you know, and it should never take + longer than 40 working days (see this + good + practice guide). + You will then either get the information that + you originally requested, or you will be told that the review upholds the + original decision. +

+ +

2. Complaining to the Information Commissioner #

+ +

If you are still unhappy after the public authority has done their internal review, + then you can complain to the Information Commissioner. To do this read + Complaints about Freedom of Information + on the Information Commissioner's website. If you requested information from a Scottish + authority, then appeal + to the Scottish Information Commissioner. +

+ +

To make it easier to send the relevant information to the + Information Commissioner, either + <% if @info_request %> + include a link to your request + <%=h request_url(@info_request) %> + <% else %> + include a link to your request on <%= site_name %> +<% end %> +in your complaint or print out the whole page of your request and all attachments. +

+ +

<%= site_name %> has no special facilities for handling a request at this stage - it + passes into the Information Commissioner's system. You can leave annotations on your + request keeping people informed of progress.

+ +

A warning. There is a backlog of work at the Information Commissioner, and + it can take literally years to get resolution from them. If you reach this point, + you should accept that you won't get the information quickly by this means. Maybe + you want to help the fight to improve Freedom of Information, or maybe + getting the information slowly is still worthwhile. You can also try and + get the information by other means...

+ +

3. Using other means to answer your question #

+ +

You can try persuing your problem or your research in other ways.

+ +
    +
  • Make a new FOI request for summary information, or for + documentation relating indirectly to matters in your refused request. + Ask us for ideas if you're stuck.
    • +
  • If any other public authorities or publicly owned companies are involved, + then make FOI requests to them.
    • +
  • Write to your MP or other politician using WriteToThem and ask for their help + finding the answer. MPs can write directly to ministers or departments, and + can ask written questions in the House of Commons. Councillors in local authorities + can talk directly to council officers.
    • + <% if can_ask_the_eu?(@country_code) %> +
  • + Try <%= link_to 'asking for the information from the European Union', + 'http://www.asktheeu.org' %>. Every one of the 500 million people + living in the European Union (both citizens and residents) has the + legally guaranteed right to ask for information from EU authorities. + <%= link_to 'Ask The EU', 'http://www.asktheeu.org' %> is a version of + this website for the European Union. +
    • + <% end %> +
  • Ask other researchers who are interested in a similar + issue to yours for ideas. You can sometimes find them by browsing this site; + contact any registered user from their page. There may be an Internet + forum or group that they hang out in. If it is a local matter, use GroupsNearYou to find such a + forum.
    • +
  • You could form a small local campaign group and arrange a meeting + with staff from the authority.
    • +
\ No newline at end of file -- cgit v1.2.3 From cec2832b8c6350fa1afd725ab60ae89b48a40b6d Mon Sep 17 00:00:00 2001 From: Louise Crow Date: Thu, 24 Nov 2016 09:52:30 +0000 Subject: Add text on request closure. --- lib/views/help/officers.html.erb | 9 +++++++++ 1 file changed, 9 insertions(+) (limited to 'lib') diff --git a/lib/views/help/officers.html.erb b/lib/views/help/officers.html.erb index 5a0418f..f0ebdb7 100644 --- a/lib/views/help/officers.html.erb +++ b/lib/views/help/officers.html.erb @@ -187,6 +187,15 @@ requests, and for good public relations, we'd advise you not to do that. +
My response to an old request on <%= site_name %> has been bounced!#
+
After six months of inactivity, <%= site_name %> limits who can respond to a request to stop + spammers targeting old requests. At that point, the request can only be responded to by someone who's + from the authority. After twelve months, the request is closed to responses from anyone. If you need an + old request to be re-opened so that you can respond to it, please + contact us. +
+ +

If you haven't already, read the introduction --> -- cgit v1.2.3 From a26a2d5bddb3cba85cbddfc7475e2706f20e34ac Mon Sep 17 00:00:00 2001 From: lizconlan Date: Fri, 2 Dec 2016 17:45:14 +0000 Subject: Update model patch example to include the default_letter param override --- lib/model_patches.rb | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'lib') diff --git a/lib/model_patches.rb b/lib/model_patches.rb index 7f3b4de..b0c906f 100644 --- a/lib/model_patches.rb +++ b/lib/model_patches.rb @@ -10,6 +10,10 @@ Rails.configuration.to_prepare do # OutgoingMessage.class_eval do # # Add intro paragraph to new request template # def default_letter + # # this line allows the default_letter text added by this + # # method to be replaced by the value supplied by the API + # # e.g. http://demo.alaveteli.org/new/tgq?default_letter=this+is+a+test + # return @default_letter if @default_letter # return nil if self.message_type == 'followup' # "If you uncomment this line, this text will appear as default text in every message" # end -- cgit v1.2.3 From b8920199aa25ef883ec4213729486f01539e2823 Mon Sep 17 00:00:00 2001 From: lizconlan Date: Mon, 28 Nov 2016 11:32:08 +0000 Subject: Add request reporting sections to the help/about page --- lib/views/help/about.html.erb | 30 +++++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) (limited to 'lib') diff --git a/lib/views/help/about.html.erb b/lib/views/help/about.html.erb index 36120f1..9f7d7d5 100644 --- a/lib/views/help/about.html.erb +++ b/lib/views/help/about.html.erb @@ -32,6 +32,34 @@ it must be kept confidential. +

What if I see a request I feel to be inappropriate? #
+
+

+ Requests for personal information and vexatious requests are not considered valid for FOI purposes (read more). +

+ +

+ If you believe a request is not suitable, you can report it for attention by the site administrators. +

+
+ +
Why won't it let me report some requests? #
+
+

+ If a request has already been reported to the site administrators, you + can't report it a second time - this is to prevent the administrators + being notified multiple times about the same issue before they've had + a chance to conduct a review. +

+ +

+ Where a request has been previously reported but an administrator has + chosen not to hide it from public view, you can use the form in the + sidebar of the request page to contact the administrators if you still + think it should be hidden. +

+
+
Who makes <%= site_name %> ? #
<%= site_name %> runs on Alaveteli, which was created and run by mySociety, and was initially funded by the JRSST Charitable Trust. mySociety is a project of the @@ -49,4 +77,4 @@

Next, read about making requests -->

- \ No newline at end of file + -- cgit v1.2.3