OpenAdapt icon indicating copy to clipboard operation
OpenAdapt copied to clipboard

Update Gitbook Getting Started guide with Screenshots

Open abrichr opened this issue 1 year ago • 12 comments

Feature request

We would like to update https://openadapt.gitbook.io/openadapt.ai/getting-started/readme/quick-start with screenshots of the new dashboard + system tray GUI functionality.

This is currently a quick-start for developers. We need a new quick-start for users

Newer functionality is documented at https://github.com/OpenAdaptAI/OpenAdapt#usage, but not for users

This involves:

  • going through the download + install + record + replay process, documenting the steps as you go (taking screenshots)
  • transferring your documentation to Gitbook via a Pull Request into https://github.com/OpenAdaptAI/OpenAdapt/tree/docs containing text and images (screenshots)
  • moving the current "quickstart" section into a legacy page.

The goal of this exercise is to have documentation for users, i.e. people with no command line experience.

I would expect to see the following rough breakdown:

A: Download and install

  1. Download OpenAdapt
  2. Install OpenAdapt (for now this is just extracting the zip)
  3. Run OpenAdapt
  4. Complete the onboarding (this is almost merged, https://github.com/OpenAdaptAI/OpenAdapt/pull/746)

B: Create a recording

  1. Right-click the tray icon -> Click "Record" -> Type a task description -> Click "OK"
  2. Open some apps, type some letters, move/click/scroll the mouse
  3. Stop the recording by pressing "Ctrl" three times
  4. Wait for it to stop

C: View the recording

  1. Right-click the tray icon -> click "Launch Dashboard" (if it isn't already running)
  2. Click "Recordings"
  3. Click on the recording you just created
  4. Scroll down through the events, removing any accidental/unnecessary actions by clicking "Delete"

D: Scrub the recording (optional)

  1. See "Scrubbing" in dashboard

E: Replay the recording

  1. Right-click the tray icon -> click "Replay" -> Select the recording
  2. Select a replay strategy (leaving the default VisualReplayStrategy is recommended)
  3. Type some text instructions
  4. Click "OK"

F: Upload your recording and replay

  1. Coming soon! (https://github.com/OpenAdaptAI/OpenAdapt/issues/767)

abrichr avatar Jun 17 '24 00:06 abrichr

/bounty $100

abrichr avatar Jun 17 '24 00:06 abrichr

💎 $100 bounty • OpenAdaptAI

Steps to solve:

  1. Start working: Comment /attempt #764 with your implementation plan
  2. Submit work: Create a pull request including /claim #764 in the PR body to claim the bounty
  3. Receive payment: 100% of the bounty is received 2-5 days post-reward. Make sure you are eligible for payouts

Thank you for contributing to OpenAdaptAI/OpenAdapt!

Attempt Started (UTC) Solution Actions
🟢 @Omar8345 Apr 13, 2025, 05:38:22 AM WIP
🟢 @onyedikachi-david Jun 17, 2024, 07:40:37 AM WIP
🟢 @shashank40 Jun 17, 2024, 12:14:54 PM #771 Reward

algora-pbc[bot] avatar Jun 17 '24 00:06 algora-pbc[bot]

/attempt #764

Algora profile Completed bounties Tech Active attempts Options
@onyedikachi-david 2 bounties from 1 project
JavaScript, Shell
Cancel attempt

onyedikachi-david avatar Jun 17 '24 07:06 onyedikachi-david

/attempt #764

Algora profile Completed bounties Tech Active attempts Options
@shashank40 2 bounties from 2 projects
Python, TypeScript,
JavaScript
Cancel attempt

shashank40 avatar Jun 17 '24 12:06 shashank40

@abrichr Just a quick question, when you say screenshots, would you prefer the ones on GitHub developer documentation? Or should we add new screenshots?

shashank40 avatar Jun 17 '24 12:06 shashank40

Thank you @shashank40! This involves taking new screenshots

abrichr avatar Jun 17 '24 15:06 abrichr

💡 @shashank40 submitted a pull request that claims the bounty. You can visit your bounty board to reward.

algora-pbc[bot] avatar Jun 18 '24 10:06 algora-pbc[bot]

Looks like this is still open sir @abrichr

onyedikachi-david avatar Sep 17 '24 15:09 onyedikachi-david

Is it still open @abrichr ?

lilsamuel2 avatar Dec 12 '24 05:12 lilsamuel2

sir @abrichr just wondering if this is still able to be claimed as I have done the screenshots. Thanks ! 👍

lilsamuel2 avatar Dec 14 '24 09:12 lilsamuel2

Hi @abrichr Is this still open?

Srija616 avatar Jan 04 '25 20:01 Srija616

/attempt #764

Omar8345 avatar Apr 13 '25 05:04 Omar8345