search

OpenDataServices / standards-lab

Open Standards Lab. A web tool for users and creators of Open Standards.
https://standards-lab.readthedocs.io/
GNU Affero General Public License v3.0
2 stars 0 forks source link

Add and review copy esp project page #92

Closed michaelwood closed 3 years ago

michaelwood commented 3 years ago
rhiaro commented 3 years ago
duncandewhurst commented 3 years ago

Hi folks,

The tool looks great! With my new-found technical writing hat on, I noticed a few areas for improvement in the UI text. I am sure there are more, but hopefully these are a useful starter for 10:

http://standards-lab.opendataservices.coop/

Current text

Open Standards Lab helps you to develop standards and improve the quality of Open Data. Please see the About pages and Documentation for more information.

Select from available projects or create a new project.

Available Projects

All projects are accessible to anyone using this system.

Create new project

Project name

Suggested changes

Clarify what users can do with the tool. Don't capitalise 'Open Data'. Make headings action-oriented and reduce duplication. Move note on visibility since it relates to both new and existing projects. Rename 'available projects' to 'existing projects'. Remove repetition of 'project name'. Replace 'create new project' to 'create a new project'.

Open Standards Lab is a tool to help you develop JSON schema and improve the quality of open data. You can:

  • Upload and edit JSON schema files
  • Upload and edit data in multiple formats
  • Test data using your schema

Projects are visible to all users.

Open an existing project

Create a new project

http://standards-lab.opendataservices.coop/p/

Current text

Schema

Schema JSON can be uploaded and edited directly. The schema must conform to JSON Schema specifications. Once saved or uploaded the schema will be used to Test any data provided. Project Schema documentation. Schema upload Current schema files

Suggested changes

Use active voice. Make labels action-oriented.

Schema

Upload and edit JSON schema files for testing your data. Your schema must conform to the JSON Schema specification. Upload a file Choose a file to edit

Current text

Data

Data can be uploaded to the project. Data can be in CSV format (.csv), JSON format (.json), Microsoft Excel (.xls and .xlsx) or Open spreadsheet format (.ods). Editing in the browser can be done on CSV and JSON files. Data upload Current data files

Suggested changes

Use active voice. Make labels action-oriented.

Data

Upload data for testing. Supported formats: .csv, .json, .xls, .xlsx, .ods. You can edit .csv and .json files after uploading. Upload data Choose a file to edit

michaelwood commented 3 years ago

Thanks for the suggestions, these are now committed https://github.com/OpenDataServices/standards-lab/commit/b8b9a7e24aedfa08b0dd82b33b32bd86d770cab7

There is/will be more copy to review but we will track those in new issues.