{"version":1,"pages":[{"id":"-LOyp82G822ekKT7Cfu_","title":"Out of date: How to write for SF.gov","pathname":"/style-guide","siteSpaceId":"sitesp_STpii","description":""},{"id":"-LPXouGfAqV3Jdx76v1I","title":"Style guide","pathname":"/style-guide/city-standards","siteSpaceId":"sitesp_STpii","description":"If you are writing for SF.gov, use the following grammar and usage, based on AP Style. If something is not listed below, use AP Style."},{"id":"-LPXhodMHnHDeDyUKRDo","title":"Content principles","pathname":"/style-guide/content-principles","siteSpaceId":"sitesp_STpii","description":"How we approach content."},{"id":"-LPXkG8sK3ar0XzmfpAi","title":"Before you write","pathname":"/style-guide/before-you-write","siteSpaceId":"sitesp_STpii","description":"Clear writing requires knowing about both your services and your users."},{"id":"-LPashRjEnLmTDjw3Iki","title":"Users","pathname":"/style-guide/before-you-write/users","siteSpaceId":"sitesp_STpii","description":"When we talk about 'users', we're talking about anyone who lives, works or visits San Francisco and needs to interact with the City.","breadcrumbs":[{"label":"Before you write"}]},{"id":"-LPat61yZb9n941UEjwD","title":"User needs","pathname":"/style-guide/before-you-write/user-needs","siteSpaceId":"sitesp_STpii","description":"User needs are what we call the task a person comes to a website or service to do.","breadcrumbs":[{"label":"Before you write"}]},{"id":"-LPXm6A_E9vofLjp1fA0","title":"Audience needs vs department needs","pathname":"/style-guide/before-you-write/audience-needs-vs-department-needs","siteSpaceId":"sitesp_STpii","description":"San Franciscans need to do things, not so much ‘find out about’ or ‘get more information on.’","breadcrumbs":[{"label":"Before you write"}]},{"id":"-LPXl1L_SRNTxnOfGGU4","title":"Get information about your users","pathname":"/style-guide/before-you-write/get-information-about-your-users","siteSpaceId":"sitesp_STpii","description":"Know the context of residents who are using your service.","breadcrumbs":[{"label":"Before you write"}]},{"id":"-LPXkpKBLmvS-_gIRxl4","title":"Talk to an expert (if you aren’t one)","pathname":"/style-guide/before-you-write/talk-to-an-expert-if-you-arent-one","siteSpaceId":"sitesp_STpii","description":"To write about your services clearly, you must understand them.","breadcrumbs":[{"label":"Before you write"}]},{"id":"-LPXlII0WF5nWd0y0nC3","title":"Decide if the department should publish the content","pathname":"/style-guide/before-you-write/decide-if-the-department-should-publish-the-content","siteSpaceId":"sitesp_STpii","description":"Sometimes creating a new webpage is not the right answer.","breadcrumbs":[{"label":"Before you write"}]},{"id":"-LPXlMuLO7QAEvPfQbjp","title":"Structure your content","pathname":"/style-guide/write-your-content","siteSpaceId":"sitesp_STpii","description":"Lay out your content and write copy San Franciscans can and will read."},{"id":"-LPXlPC7Ba9H8xnSxHLT","title":"Structure the page","pathname":"/style-guide/write-your-content/structure-the-page","siteSpaceId":"sitesp_STpii","description":"Who is the page for and what does that person need to do?","breadcrumbs":[{"label":"Structure your content"}]},{"id":"-LPXmNSj5r-A9h8hO3SL","title":"One user and one need per page","pathname":"/style-guide/write-your-content/structure-the-page/one-user-and-one-need-per-page","siteSpaceId":"sitesp_STpii","description":"Webpages are for one type of audience only.","breadcrumbs":[{"label":"Structure your content"},{"label":"Structure the page"}]},{"id":"-LPXmaXRlZa_3KyBH5Pl","title":"Titles","pathname":"/style-guide/write-your-content/titles","siteSpaceId":"sitesp_STpii","description":"The title should reflect what the user wants to do.","breadcrumbs":[{"label":"Structure your content"}]},{"id":"-LPXmgJEjBUtXQnhMRUy","title":"Summaries","pathname":"/style-guide/write-your-content/summaries","siteSpaceId":"sitesp_STpii","description":"A description or summary should explain more about the action the user wants to do.","breadcrumbs":[{"label":"Structure your content"}]},{"id":"-LPXmoEXsDS2IfKAFqkG","title":"Just enough information","pathname":"/style-guide/write-your-content/have-just-enough-information","siteSpaceId":"sitesp_STpii","description":"The less information you give the user, the more they can focus.","breadcrumbs":[{"label":"Structure your content"}]},{"id":"-LPXn6ZaK4EDG1xu5EPP","title":"Headings","pathname":"/style-guide/write-your-content/headings","siteSpaceId":"sitesp_STpii","description":"Write clear, simple headings to anchor your text.","breadcrumbs":[{"label":"Structure your content"}]},{"id":"-LPXnDu8s4BFJ1x1Y6PL","title":"Don’t duplicate","pathname":"/style-guide/write-your-content/write-it-once","siteSpaceId":"sitesp_STpii","description":"Don't add a page if a credible site has the same content.","breadcrumbs":[{"label":"Structure your content"}]},{"id":"-LPXnTdWIQOs-_KiiHpy","title":"Writing copy","pathname":"/style-guide/writing-copy","siteSpaceId":"sitesp_STpii","description":"Writing for people reading on screens must be clear, simple, and direct."},{"id":"-LPXn_TxaxjB3fQU_xgM","title":"Address the user as 'you'","pathname":"/style-guide/writing-copy/address-the-user-as-you","siteSpaceId":"sitesp_STpii","description":"Anything you put on the web is a conversation.","breadcrumbs":[{"label":"Writing copy"}]},{"id":"-LPXnhtk6tXmlJDPGZ24","title":"Avoid gender-specific pronouns","pathname":"/style-guide/writing-copy/avoid-gender-specific-pronouns","siteSpaceId":"sitesp_STpii","description":"Don’t use pronouns like ‘he,’ ‘she,’ and ‘hers.’","breadcrumbs":[{"label":"Writing copy"}]},{"id":"-LPXnvR0voolLovZgcSU","title":"Readability","pathname":"/style-guide/writing-copy/readability","siteSpaceId":"sitesp_STpii","description":"Your writing must be at or below a 5th grade reading level to reach all San Franciscans.","breadcrumbs":[{"label":"Writing copy"}]},{"id":"-LPXo32_OcvOw_9QnpV7","title":"Write short sentences","pathname":"/style-guide/writing-copy/readability/write-short-sentences","siteSpaceId":"sitesp_STpii","description":"Ideally, sentences should be 10-15 words maximum.","breadcrumbs":[{"label":"Writing copy"},{"label":"Readability"}]},{"id":"-LPXo7y1vK23tTzS8gVT","title":"Use strong verbs","pathname":"/style-guide/writing-copy/readability/use-strong-verbs","siteSpaceId":"sitesp_STpii","description":"Strong verbs tell readers what they need to do.","breadcrumbs":[{"label":"Writing copy"},{"label":"Readability"}]},{"id":"-LPXoPi_SNMBc9w8vJ-y","title":"Use active voice","pathname":"/style-guide/writing-copy/readability/use-active-voice","siteSpaceId":"sitesp_STpii","description":"Writing in the passive voice makes your content more difficult to understand.","breadcrumbs":[{"label":"Writing copy"},{"label":"Readability"}]},{"id":"-M1kzbrJncFq1D-glpmp","title":"Write positively","pathname":"/style-guide/writing-copy/readability/write-positively","siteSpaceId":"sitesp_STpii","description":"","breadcrumbs":[{"label":"Writing copy"},{"label":"Readability"}]},{"id":"-LPXooe0s4XryifTf6j3","title":"Editing","pathname":"/style-guide/editing","siteSpaceId":"sitesp_STpii","description":"After your first draft, you will need to edit your content."},{"id":"-LPXssCMga2Tw-Ja8N-L","title":"Templates on SF.gov","pathname":"/style-guide/templates","siteSpaceId":"sitesp_STpii","description":"When you are writing content for SF.gov, you will need to use templates to add pages."},{"id":"-Ln-TD8j32lFIC5fX_eg","title":"Transaction","pathname":"/style-guide/templates/transaction-page","siteSpaceId":"sitesp_STpii","description":"Use for something a resident can do.","breadcrumbs":[{"label":"Templates on SF.gov"}]},{"id":"-Ln-Tz-fwXNzBDdiEKLR","title":"Information","pathname":"/style-guide/templates/information-page","siteSpaceId":"sitesp_STpii","description":"Use for background information users might need to know. Don’t use where users need to do something.","breadcrumbs":[{"label":"Templates on SF.gov"}]},{"id":"-Ln-Unz67c87I67UI1Yl","title":"News story","pathname":"/style-guide/templates/news-story","siteSpaceId":"sitesp_STpii","description":"Use for recent newsworthy updates or press releases","breadcrumbs":[{"label":"Templates on SF.gov"}]},{"id":"-Ln-UQycu_13-989_sau","title":"Event","pathname":"/style-guide/templates/event","siteSpaceId":"sitesp_STpii","description":"Use for a one-time public event that has a date and location","breadcrumbs":[{"label":"Templates on SF.gov"}]},{"id":"-LPXszFmfXu2ba8CXiUe","title":"Resources","pathname":"/style-guide/resources","siteSpaceId":"sitesp_STpii","description":""},{"id":"-LPXt7dUPml4weXk39Wr","title":"Get help","pathname":"/style-guide/get-help","siteSpaceId":"sitesp_STpii","description":""},{"id":"-LPXumlcVHxslI7qWF0q","title":"Recommended reading","pathname":"/style-guide/recommended-reading","siteSpaceId":"sitesp_STpii","description":"Specialist reading recommended by the content design community."},{"id":"-M7xkRm-a_XX8Z5kJd8Z","title":"Why forms?","pathname":"/style-guide/how-to-write-forms/why-forms","siteSpaceId":"sitesp_STpii","description":"Forms allow users to enter information into a page.","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xlY9_TWgfTxngoklD","title":"Form principles","pathname":"/style-guide/how-to-write-forms/form-principles","siteSpaceId":"sitesp_STpii","description":"","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xmK4xPpkWnz_2YxLg","title":"Form structure","pathname":"/style-guide/how-to-write-forms/form-structure","siteSpaceId":"sitesp_STpii","description":"","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xmtl_sti42WPzaV2j","title":"Labels","pathname":"/style-guide/how-to-write-forms/labels","siteSpaceId":"sitesp_STpii","description":"Labels are the words above inputs on your form.","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xnXJdcypv64G8JHR-","title":"Inputs","pathname":"/style-guide/how-to-write-forms/inputs","siteSpaceId":"sitesp_STpii","description":"","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xoQKC-JZe47oTwxaE","title":"Options","pathname":"/style-guide/how-to-write-forms/options","siteSpaceId":"sitesp_STpii","description":"Also called “answers”","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xon2wVdPUkXojvSbN","title":"Help and instructional text","pathname":"/style-guide/how-to-write-forms/help-and-instructional-text","siteSpaceId":"sitesp_STpii","description":"","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xpN6agmtsbS9loM5m","title":"Default values","pathname":"/style-guide/how-to-write-forms/default-values","siteSpaceId":"sitesp_STpii","description":"","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xpkL33sCWMY6YMEJD","title":"Mandatory or optional fields","pathname":"/style-guide/how-to-write-forms/mandatory-or-optional-fields","siteSpaceId":"sitesp_STpii","description":"Decide if you must have a field. Show that a field is mandatory with an asterisk.","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xwk8PJhX5AyF7WFGC","title":"Conditionals","pathname":"/style-guide/how-to-write-forms/conditionals","siteSpaceId":"sitesp_STpii","description":"A conditional is a field that appears based on the answer to a previous question.","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xxZRe1YkzsgHk4iPI","title":"Error messages and validation","pathname":"/style-guide/how-to-write-forms/error-messages-and-validation","siteSpaceId":"sitesp_STpii","description":"","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xy98QP5EdzwHyEjTi","title":"The end of a form","pathname":"/style-guide/how-to-write-forms/the-end-of-a-form","siteSpaceId":"sitesp_STpii","description":"Tell a user what they told you on the form and what to expect next","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xz0hUn6-uv_4iIDUx","title":"Resources","pathname":"/style-guide/how-to-write-forms/resources","siteSpaceId":"sitesp_STpii","description":"","breadcrumbs":[{"label":"How to write forms"}]},{"id":"-M7xzY-CQ2t4KgtuWqfV","title":"Get help","pathname":"/style-guide/how-to-write-forms/get-help-1","siteSpaceId":"sitesp_STpii","description":"","breadcrumbs":[{"label":"How to write forms"}]}]}