[WIP] Pre-pre drafts for Getting Started and Interactors parts of documentation

[minkimcello]

Motivation

To get some inspiration on how we should approach our docs, I reviewed Gatsby, MSW, Redux, React, Ember, and Cypress's websites, and I came to the conclusion that it should be catered to the tool/framework itself.

The principle I'm trying to follow is that a good doc should read like a book and users should be able to read from top to bottom and get a good understanding of BigTest without having to hop back and forth.

Approach

Without adding actual pages, I just added markdown files in directories to help visualize what our dropdown menu should look like. Click on the links of the tree below to see what I wrote so far:

• Getting Started
  • Installation
  • Writing Your First Test
• Guides
  • Interactors
    • What are Interactors - empty
    • Built-in Interactors
    • Locators and Filters
  • Development Workflow
    • bigtest server vs bigtest test vs bigtest ci
    • Setting up CI
      • Github Actions
      • CircleCI
  • Configure Browsers
    • webdriver caveats
    • multi-browser parallel testing
  • iOS and Android Simulators
  • Setup Code Coverage
• Concepts
  • Test Tree
  • Steps and Assertions
    • Grouping syntax
    • Describe how steps always run before assertions
    • Declarative tests as @jorgelainfiesta mentioned. This section can be linked to earlier in the guides so when people are reading about interactors and thinking "okay, how do I write assertions or steps without interactors?"
• API
• Stubbing API

[changeset-bot]

⚠️ No Changeset found

Latest commit: 1421b71

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[github-actions]

📣 NOTIFICATION

You are receiving this message because we did not publish any packages.

Generated by 🚫 dangerJS against 1421b71

[minkimcello]

Closing because of #662