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

Allow organizing tours within sub-directories #50

Open
jfloresremar opened this issue Apr 3, 2020 · 10 comments · May be fixed by #245
Open

Allow organizing tours within sub-directories #50

jfloresremar opened this issue Apr 3, 2020 · 10 comments · May be fixed by #245
Labels

Comments

@jfloresremar
Copy link

Thank you for your great extension.
Sometimes we could have multiple tours, which would be good to organize with folders (physical or virtual) or tags with search capabilities

@lostintangent lostintangent added area: recording enhancement New feature or request labels Apr 3, 2020
@gracegtaylor
Copy link

Hi there, thanks for the suggestion! We will look into adding this to our backlog.

@lostintangent
Copy link
Member

@jfloresremar Thanks for reaching out! Could you explain a little bit more about what you're looking to do? Right now, tour files are written to the .vscode/tours folder in your project. Are you interested in adding sub-directories to that folder and having the CodeTour player discover them?

Or are you simply looking to be able to tag a tour, and have the tours be grouped by tag in the CodeTour tree? I just ask so we can best understand what you're thinking. Thanks!

@jfloresremar
Copy link
Author

Hello @lostintangent. At the moment I am gradually developing a large project. For me CodeTour is an excellent tool for practitioners developers to easily integrate into the project and I want to document everything from the beginning with both .md files (docsify) and CodeTour.

I have generated two Tours that I have called "Amplify" and "Status" but both tours are not enough to explain everything related to these topics. When creating tours for each specific topic I will end having an extensive list of tours.
image

I think this enhancement is related with #44 and i'd like to see tours in a treeview something like this:
image

Thank you!

@lostintangent
Copy link
Member

lostintangent commented Apr 5, 2020

Thanks so much for that clarification! In order to create that structure, what do you think about creating actual directories within the “.vscode/tours” folder, and then placing the respective tour files in them?

Or we’re you thinking about some other solution for authoring this structure? For example, we could enable adding tags to a tour and grouping tours by tag. But if you want an arbitrarily deep nesting hierarchy, it might be simpler to just organize tours into sub directories and have the tree view reflect that same hierarchy. Thoughts?

@jfloresremar
Copy link
Author

jfloresremar commented Apr 6, 2020

Thanks so much for that clarification! In order to create that structure, what do you think about creating actual directories within the “.vscode/tours” folder, and then placing the respective tour files in them?

Yes, I prefer creating directories (and sub directories) inside ".vscode/tours

About searching i can use the search tool of vscode, just typing "./vscode/tours" inside "files to include"
image

Thank you!

@lostintangent
Copy link
Member

@jfloresremar Awesome! Alright, then maybe I'll update this issue title to be focused on enabling folder organization then?

@lostintangent lostintangent changed the title Allow organizing tours with folders or tags Allow organizing tours within sub-directories Apr 6, 2020
@lostintangent lostintangent removed the P2 label Oct 29, 2020
@gracegtaylor gracegtaylor added the P2 label Nov 9, 2020
@hallvard
Copy link

Related to this is the possibility to have a hierarchy within a tour, e.g. I have a tour for a multi-module maven project and have added directory steps for each sub-module followed by steps that explain files within it. It would be great if steps related to that directory/sub-module could be nodes inside the directory step instead. I end up with a very long list that doesn't really show its (natural) hierarchical structure and it's very difficult to skip steps related to that directory/sub-module.

@tsleal29
Copy link

Hi! We use your extension in a big project and thought it might be useful to have the tours organized by folder. I came here looking for an open issue related to this and found this one so I'll just post it here.

We'd like to contribute to the extension by coding this feature ourselves if this can help! I gave a look at the readme but couldn't manage to test my code by myself. I'd like to know if you'd be able to help us with the first steps and to decide what would be the best approach, as you know the code way better than us, and we try to continue from there.

Please let me know if you can help us! :)
Thanks!

@tsleal29
Copy link

@lostintangent sorry to tag you but I don't know if someone will see my message as this issue hasn't been active for a while now and I didn't want to open a new one for the same thing.

@Miko321
Copy link

Miko321 commented Apr 4, 2022

I'm also looking for this, as it helps organize when there are too many tours.
@lostintangent There's any chance of implementing this feature?

@daiyam daiyam linked a pull request Jun 10, 2022 that will close this issue
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging a pull request may close this issue.

6 participants