Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Migrate instructions content to the GitHub wiki #231

Open
5 tasks
jweisz opened this issue Apr 21, 2023 · 11 comments
Open
5 tasks

Migrate instructions content to the GitHub wiki #231

jweisz opened this issue Apr 21, 2023 · 11 comments
Assignees
Labels

Comments

@jweisz
Copy link
Collaborator

jweisz commented Apr 21, 2023

We decided to move instructional content to the wiki:

  • tjbot hardware setup instructions (from the front page), including separate pages for each kind of RPi (3, 4, Pi Zero 2, etc.)
  • troubleshooting guide (from TROUBLESHOOTING.md)
  • Watson credentials guide
  • bootstrap instructions
  • hardware tests
@jweisz
Copy link
Collaborator Author

jweisz commented May 5, 2023

Here are the new hardware setup instructions: [Watson Services in IBM Cloud v3.docx](https://github.com/ibmtjbot/tjbot/files/10415863/Watson.Services.in.IBM.Cloud.v3.docx]

@jweisz
Copy link
Collaborator Author

jweisz commented May 5, 2023

The wiki is in progress! And we have a very cool cover image :D

@jweisz
Copy link
Collaborator Author

jweisz commented Jun 16, 2023

Feedback from June 16:

  • Can we fix the order of the links in the sidebar?

  • About TJBot

  • Build TJBot

  • Bring TJBot to life

  • Recipes (or "Official Recipes")

  • Community Recipes (rename it from "Featured Recipes")

  • Testing

  • Troubleshooting (maybe merge with Testing?)

  • Tutorials (maybe merge with Bring TJBot to Life?)

  • Contribute

  • Need to add Lisa's material on provisioning cloud services

@heather-fillerup-miller

The default behavior for the sidebar topics is alphabetical, but I believe there is a way to customize it, so I will look into.

I agree with the renames and merging Tutorials into Bring TJBot to life, but maybe we should merge Testing into Troubleshooting rather than the other way around?

I am also working with Lisa to get her cloud service materials added. We ran into an issue with the markdown conversion of the images from Word.

@jweisz
Copy link
Collaborator Author

jweisz commented Jun 29, 2023

Testing feels like a thing everyone should do after building their TJBot. Troubleshooting feels like the place you go when you run into problems at any phase. So maybe these really are separate?

@heather-fillerup-miller

I think it makes sense to keep the testing separate from troubleshooting since it is something that should be done before using the recipes to ensure that the hardware is set up and working properly.

My plan was to add the README content from the tests folder so this section has a link to the tests folder and explains how to run the tests.

Maybe we rename it to "TJBot Hardware Tests"? That way it is more descriptive?

@jweisz
Copy link
Collaborator Author

jweisz commented Jun 30, 2023

"TJBot Hardware Tests" or "Hardware Tests" sounds good. Thanks @heather-fillerup-miller !

@heather-fillerup-miller
Copy link

heather-fillerup-miller commented Sep 30, 2023

Added Lisa's Watson Services section and converted all images from inches to pixels. Renamed sections based on discussion above. Also created custom side bar.

I think we can close this issue now.

@heather-fillerup-miller
Copy link

heather-fillerup-miller commented Oct 6, 2023

Don't close: Found issues with links in Recipes, need to clean up and link to READMEs, remove instructable links, and check product links.

@heather-fillerup-miller

Made updates to wiki, links seems to working appropriately now, the issue was when I created a custom side bar, it broke the internal linking to the markdown files in the wiki repo.

@jweisz
Copy link
Collaborator Author

jweisz commented Mar 29, 2024

@heather-fillerup-miller @jweisz let's take a pass through the wiki content and clean up language like "TJBot is optimized for RPi 3" since that's not exactly true anymore :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants