You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
In the included Neovim Tutor (Lesson 1.6: EDITING A FILE), the user is instructed to run `nvim tutor` from a second terminal.
This is confusing for users who expect an integrated sub-lesson (or a dedicated practice file) inside kickstart.nvim’s tutorial flow.
It isn’t obvious that they’re just editing a blank “tutor” file with no automated “check” or linking back to the main tutorial.
Details
What happens: Lesson 1.6 says:
If can access to another terminal, do the following there:
$ nvim tutor
Then `:wq` to save. But there is no actual sub-lesson in that file, nor an automatic check that the user completed the practice.
What we expected:
Possibly a specific practice file that is recognized by the tutorial, e.g. “kickstart_lesson_1_6.txt.”
When the user returns to the Tutor, a checkmark or some feedback that Lesson 1.6 is “done.”
Clear instructions on how to link the user’s edits back to the main lesson flow.
Why It Matters
Newcomers see `nvim tutor` and assume it’s an official sub-lesson integrated with the main tutorial, but it’s just a generic “tutor” file name.
Because there is no auto-check for completion, users wonder if they did everything correctly or if the tutorial should reflect “Lesson 1.6 complete.”
Proposed Solutions
Update the text in Lesson 1.6 to clarify:
"Open a second terminal and run `nvim some_practice_file`. Once you edit and save, come back to the Tutor. (Note: there’s no auto-check; just practice the commands.)"
Optionally: Provide a short dummy file (e.g., `.local/share/nvim/kickstart_lesson_1_6.txt`) which the user can edit so that the main Tutor sees changes (if you plan to implement any form of “completion” check).
Or simply rename the file name in instructions from “tutor” to something less confusing like “mypractice.txt.”
Thanks for all your work on kickstart.nvim—really helpful for new Neovim users!
The text was updated successfully, but these errors were encountered:
Summary
In the included Neovim Tutor (Lesson 1.6: EDITING A FILE), the user is instructed to run `nvim tutor` from a second terminal.
This is confusing for users who expect an integrated sub-lesson (or a dedicated practice file) inside kickstart.nvim’s tutorial flow.
It isn’t obvious that they’re just editing a blank “tutor” file with no automated “check” or linking back to the main tutorial.
Details
What happens: Lesson 1.6 says:
If can access to another terminal, do the following there:
$ nvim tutor
Then `:wq` to save. But there is no actual sub-lesson in that file, nor an automatic check that the user completed the practice.
What we expected:
Why It Matters
Proposed Solutions
Thanks for all your work on kickstart.nvim—really helpful for new Neovim users!
The text was updated successfully, but these errors were encountered: