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

Help may teach by showing #26

Open
quozl opened this issue Feb 12, 2018 · 0 comments
Open

Help may teach by showing #26

quozl opened this issue Feb 12, 2018 · 0 comments

Comments

@quozl
Copy link
Contributor

quozl commented Feb 12, 2018

We have a Help button which shows a few commands, added in 2012 by @godiard and @aguzubiaga.

We also have Activity Help via the Frame or alt-shift-h, which shows terminal.rst.

We might extend this into a scripted demonstration;

  • a popup help window, with a Vte, explanatory text, reload, forward and backward buttons,
  • a series of topics, starting with basics,
  • some script(1) files with timings, along with scriptreplay(1) output to the Vte, see also asciinema for a more modern alternative,

Topics might include;

  • recognising the prompt and the text cursor,
  • typing a command, and seeing it echo, e.g. df -h ., and recognising the output,
  • fundamentals of a REPL; that it waits forever, it does exactly what you ask, it is repeatable,
  • making mistakes; shell command recall and editing, accidental destruction,
  • copying and pasting commands,
  • scrolling through long output (ls -laR); returning to the prompt,
  • typical user-level tasks; filesystem tools, starting graphical programs, using the Python REPL,
  • typical sugar tasks; gsettings, cloning an activity,
  • typical system-level tasks; investigating a system, installing software; with context recognition for Fedora or Debian systems,
  • finding commands for a task; other documentation,

Implode activity has this kind of embedded help. Please try it out.

screenshot_ubuntu-xenial_2018-02-13_08 09 59

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

No branches or pull requests

1 participant