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

Annotorious 3: write a basic 'Getting Started' guide #298

Open
rsimon opened this issue Sep 22, 2023 · 6 comments
Open

Annotorious 3: write a basic 'Getting Started' guide #298

rsimon opened this issue Sep 22, 2023 · 6 comments
Labels
help wanted Extra attention is needed v3.x Work on the next major release

Comments

@rsimon
Copy link
Member

rsimon commented Sep 22, 2023

Important this issue is about Annotorious v3, which is currently a separate branch in this repository.

Annotorious is about to get a new major release. Annotorious 3 is a complete re-write, and will fix many of the issues that people had with the previous version. At the moment, however, it is almost completely undocumented. If anyone wants to help with testing & documentation, that would be amazing.

Task: make a test installation, test the minimal project setup, and document the "Getting Started" steps for Annotorious 3. Ideally as a markdown page in the docs folder. Ping me if you want to help!

@rsimon rsimon added help wanted Extra attention is needed hacktoberfest labels Sep 22, 2023
@rsimon rsimon changed the title Documentation Write a basic 'Getting Started' Guide Sep 22, 2023
@rsimon rsimon changed the title Write a basic 'Getting Started' Guide Write a basic 'Getting Started' guide Sep 22, 2023
@rsimon rsimon transferred this issue from another repository Oct 1, 2023
@rsimon rsimon changed the title Write a basic 'Getting Started' guide Write a basic 'Getting Started' guide for Annotorious 3 Oct 1, 2023
@rsimon rsimon added the v3.x Work on the next major release label Oct 1, 2023
@rsimon rsimon changed the title Write a basic 'Getting Started' guide for Annotorious 3 Annotorious 3: write a basic 'Getting Started' guide Oct 1, 2023
@JamMaster1999
Copy link

JamMaster1999 commented Jan 10, 2024

Hello I would be happy to help if that is something you still need. @rsimon

@rsimon
Copy link
Member Author

rsimon commented Jan 10, 2024

That would be great! ❤️

@JamMaster1999
Copy link

Ok great, can you tell me which brand is for Version 3.0? I'm quite confused about that haha. Is it the main branch? I assume you want the installation docs to be formatted the same as Version 2.0?

@rsimon
Copy link
Member Author

rsimon commented Jan 10, 2024

Hi, yes, v3 is now the main branch. (The old version keeps living on in the 2.x branch)

In terms of formatting: don't bother about it too much. I'm likely going to re-design the site eventually. Any documentation will be fine as long as it's a Markdown document. My suggestion would be to simply fork this repo, and create a new .md page in the docs/ folder. Eventually, all will go on the proper website. But for now, the docs/ folder is going to be the starting point for the new documentation.

@JamMaster1999
Copy link

Sounds good. I am quite busy at work this week and its my birthday this weekend so I can start working on it later next week. I would also be happy to help with the website redesign when the time comes if you like my work. You can see my latest work here: uflo.io

@rsimon
Copy link
Member Author

rsimon commented Jan 10, 2024

Happy birthday :-)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
help wanted Extra attention is needed v3.x Work on the next major release
Projects
None yet
Development

No branches or pull requests

2 participants