Skip to content

Commit

Permalink
Docs: fixed the broken links (#13915)
Browse files Browse the repository at this point in the history
  • Loading branch information
Rajakavitha1 committed Jun 19, 2022
1 parent 49d181a commit ec8e5bc
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 10 deletions.
12 changes: 6 additions & 6 deletions docs/career-and-open-positions/senior-software-engineer.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,14 +38,14 @@ Wherever you want!

## **Perks!!!**

* **Flexible work environment as fully remote** - we don’t look at when you log in, log out or how much time you work. We trust you, it’s the only way remote can actually work.
* **Flexible work environment as fully remote** - we don’t look at when you log in, log out or how much time you work. We trust you, it’s the only way remote can actually work.
* [**Unlimited vacation policy**](https://handbook.airbyte.io/people/time-off) with mandatory minimum time off - so you can fit work around your life.
* [**Co-working space stipend**](https://handbook.airbyte.io/people/expense-policy#work-space) - we provide everyone with $200/month to use on a coworking space of their choice, if any.
* [**Parental leave**](https://handbook.airbyte.io/people/time-off#parental-leave) \(for both parents, after one year spent with the company\) - so those raising families can do so while still working for us.
* **Open book policy** - we reimburse books that employees want to purchase for their professional and career development.
* **Continuous learning / training policy** - we sponsor the conferences and training programs you feel would add to your development in the company.
* **Health insurance** for those from countries that do not provide this freely. Through Savvy in the US, which means you can choose the insurance you want and will receive a stipend from the company.
* **401k** for the US employees.
* **Open book policy** - we reimburse books that employees want to purchase for their professional and career development.
* **Continuous learning / training policy** - we sponsor the conferences and training programs you feel would add to your development in the company.
* **Health insurance** for those from countries that do not provide this freely. Through Savvy in the US, which means you can choose the insurance you want and will receive a stipend from the company.
* **401k** for the US employees.
* **Sponsored visas** for those who need them
* We'll give you a corporate card for expenses. Our philosophy is Freedom & Responsibiility. We trust you, just do what's best for the company.

Expand All @@ -56,7 +56,7 @@ We are an open company, we are opinionated and public about how we think!
* Our [company handbook](https://handbook.airbyte.io/),
* Our [culture & values](https://handbook.airbyte.io/company/culture-and-values),
* Our [strategy](https://handbook.airbyte.io/strategy/strategy),
* Our [roadmap](https://docs.airbyte.io/roadmap),
* Our [roadmap](https://handbook.airbyte.com/strategy/roadmap),
* The [future of data integration](https://airbyte.io/articles/data-engineering-thoughts/why-the-future-of-etl-is-not-elt-but-el/)

## **Applying**
Expand Down
8 changes: 4 additions & 4 deletions docs/contributing-to-airbyte/updating-documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,11 +53,11 @@ yarn serve
You can now navigate to [http://localhost:3000/](http://localhost:3000/) to see your changes. You can stop the running server in OSX/Linux by pressing `control-c` in the terminal running the server

### Deploying the docs website
We use Github Pages for hosting this docs website, and Docusaurus as the docs framework. An [internal guide for deployment lives here](https://github.com/airbytehq/runbooks/blob/master/deploying_and_reverting_docs.md).
We use Github Pages for hosting this docs website, and Docusaurus as the docs framework. An [internal guide for deployment lives here](/docs/docusaurus/deploying_and_reverting_docs.md).

The source code for the docs lives in the [airbyte monorepo's `docs/` directory](https://github.com/airbytehq/airbyte/tree/master/docs). To publish the updated docs on this website after you've committed a change to the `docs/` markdown files, it is required to locally run a manual publish flow. Locally run `./tools/bin/deploy_docusaurus` from the `airbyte` monorepo project root to deploy this docs website.

Automating this process via CI is currently not easy because we push to a [dedicated repo hosting the Github pages](https://github.com/airbytehq/airbytehq.github.io) from the `airbyte` monorepo, which is hard to do in CI. This is not intended to be the end state (we will need to publish these docs via CI eventually), but as of May 2022 have decided the juice isn't worth the squeeze just yet.
Automating this process via CI is currently not easy because we push to a [dedicated repo hosting the Github pages](https://airbytehq.github.io) from the `airbyte` monorepo, which is hard to do in CI. This is not intended to be the end state (we will need to publish these docs via CI eventually), but as of May 2022 have decided the juice isn't worth the squeeze just yet.

## Documentation Best Practices

Expand Down Expand Up @@ -105,7 +105,7 @@ It's hard to pin down exactly what to do around source code comments, but there
**If something is not obvious, write it down**. Examples include:

* non-trivial class definitions should have docstrings
* magic variables should have comments explaining why those values are used \(e.g: if using a page size of 10 in a connector, describe why if possible. If there is no reason, that's also fine, just mention in a comment\).
* magic variables should have comments explaining why those values are used \(e.g: if using a page size of 10 in a connector, describe why if possible. If there is no reason, that's also fine, just mention in a comment\).
* Complicated subroutines/logic which cannot be refactored should have comments explaining what they are doing and why

**If something is obvious, don't write it down** since it's probably more likely to go out of date. For example, a comment like `x = 42; // sets x to 42` is not adding any new information and is therefore better omitted.
Expand Down Expand Up @@ -147,7 +147,7 @@ The emojis help us identify which commits should be included in the product rele
2. A description of the problem itself
3. Good places to start reading and file changes that can be skipped

Some examples:
Some examples:

_insufficient context_: `Create an OpenAPI to JSON schema generator`. Unclear what the value or problem being solved here is.

Expand Down

0 comments on commit ec8e5bc

Please sign in to comment.