Converting documents to tutorials or templates through the UI about grist-core HOT 7 OPEN

As a user I would think it's a bit hidden to put that in the settings, or at least it's not enough , I may think common user journey could be. :

1. I know I want the file as a tutorial from the beginning and I want to choose that option when I'm creating the doc so when I click to 'Add new' I will have on the dropdown list ' Create a new tutorial ' or 'Create a new template '
2. I don't know firstly that my document could be a tutorial or a template but I realized later it could be useful (because I'm a Grist Genius whaou ) for me or my colleagues and I may want to share it so I. suggest adding on the dropdown list clicking on the share icon : 'Convert to a tutorial / Convert into template or Copy as a tutorial / Copy as a template [because I suppose in that case you may want to copy it'
3. I will add than me (Lucie) as a new user of Grist I was looking after a 'file' button with saving/export options but for now the closest iseems to be the sharing button

from grist-core.

Here is a mockup proposal for the "Nature of the document":

Some notes:

• this field would be located at the "Document settings" pane;
• it should be localized;
• for the mockup, I used a regular <select> HTML element for simplicity, but it should in fact reuse the same components as the other fields above;
• When the value is changed, the document should be reloaded automatically so the changes take effet;
• I am not sure about the wordings;

from grist-core.

Are there specific conditions that need to be met in order for a document to be turned into a tutorial or template ? e.g. can you make a tutorial if there is no GristDocTour table in your document ?

If so, we might need to think about helpful error messages :)

from grist-core.

e.g. can you make a tutorial if there is no GristDocTour table in your document ?

Hmm, I think so, so I would say no need for handling error or exceptional cases.

from grist-core.

BTW, it may be worth keeping in mind, as far as what's the common user journey, that very few documents are templates, and even fewer are tutorials. And few users would be creators of templates or tutorials, compared to all users creating Grist docs. On the other hand, these numbers will increase if this is made more convenient (but it would still be relatively uncommon).

from grist-core.

Thanks for your feedback @lusebille!

I know I want the file as a tutorial from the beginning and I want to choose that option when I'm creating the doc so when I click to 'Add new' I will have on the dropdown list ' Create a new tutorial ' or 'Create a new template '

Unfortunately, at least as of today, there is currently a subtlety: you must first create a regular document and prepare your template or tutorial. Only once it is ready, you may convert it to a tutorial or a template. Also if you want to modify a tutorial or a template, you should first convert it back to a regular doc.

I know I want the file as a tutorial from the beginning and I want to choose that option when I'm creating the doc so when I click to 'Add new' I will have on the dropdown list ' Create a new tutorial ' or 'Create a new template '

Interesting. I would suggest doing that either in replacement of this issue or as a complement in another issue then, but it would be out of scope of the need as expressed at the beginning. Do you have any thoughts?

I will add than me (Lucie) as a new user of Grist I was looking after a 'file' button with saving/export options but for now the closest iseems to be the sharing button

Yeah, you make a valid point! If I understand correctly, you would have liked to find the "export" as a menu item of a "file" button.
There is an UX improvement to make, these issues are related: #754, #951, and maybe #540

Maybe we could create a meta-issue to track that? But also out of scope here (which does not mean it is not interesting!)

from grist-core.