Skip to content

Commit

Permalink
replaced index with quick start by roles guide
Browse files Browse the repository at this point in the history
  • Loading branch information
KarenJewell committed Sep 16, 2023
1 parent 7f19620 commit db894df
Showing 1 changed file with 23 additions and 3 deletions.
26 changes: 23 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,14 +5,34 @@

</style>

# Quick start guide
Welcome to the documentation for [opendata.scot](https://opendata.scot/)!

- Read about the project, its history, what it's trying to do, what it's achieved, and where it's headed in the **About** section
This page is intended to point you to the information that matters most to you, dependent on whether you're coming to Open Data Scotland as an Analyst, Data Engineer or Web Developer.

### Analyst
- See the opendata.scot dataset listing in [json format](https://opendata.scot/datasets.json)
- Discover stories about visitor behaviour on opendata.scot by look at our [site analytics data output](https://github.com/OpenDataScotland/opendata.scot_analytics) or [in browser version](https://opendata.scot/about/siteanalytics/)
- Browse inspiring examples of [other projects using open data](https://opendata.scot/resources/) both in Scotland and abroad
- Reference guides for [working with Scottish open data](https://opendata.scot/resources/)

- Use the **Architecture** section to understand how the project is laid out, what all the various parts are, and how it is all connected.
## Data Engineer
- Learn about our [pipeline architecture](architecture/architecture.md) and the [tools and tech we use in the pipeline](architecture/tools-and-tech.md)
- Understand how the [repos are used](architecture/repositories.md)
- For data engineering, the three most important repos used in the pipeline are
- [the-od-bods](https://github.com/OpenDataScotland/the_od_bods) for scaping and sourcing
- [opendata.scot_pipeline](https://github.com/OpenDataScotland/opendata.scot_pipeline) repo where the scheduled pipeline actions are, and
- [JKAN](https://github.com/OpenDataScotland/jkan) for output display.

## Web Developer
- The most important repo for the web developer is the [JKAN](https://github.com/OpenDataScotland/jkan) repo where all code for the static site is kept.
- Read this guide on how to [deploy the front-end for testing locally](contribute/how-to-run-frontend-locally.md)


## Other
- Read about the project, its history, what it's trying to do, what it's achieved, and where it's headed in the [About](about/about-the-project.md) section

- Browse the [Contribute](contribute/contribution-guide.md) section for step-by-step guides on how to run the project locally and other repeating tasks we keep forgetting.

- Browse the **Contribute** section for step-by-step guides on how to run the project locally and other repeating tasks we keep forgetting.

If you have any questions, feedback or general comments, definitely [contact the team](about/contact.md)

0 comments on commit db894df

Please sign in to comment.