Project

General

Profile

Feature #11949

Feature #5464: Revamp Greeter interface

Feature #8230: Greeter revamp: Phase 1

Feature #5680: New Greeter UI: update documentation

Prepare new Greeter documentation for inline help

Added by sajolida almost 2 years ago. Updated over 1 year ago.

Status:
Resolved
Priority:
Elevated
Assignee:
-
Category:
-
Target version:
Start date:
11/17/2016
Due date:
% Done:

100%

QA Check:
Feature Branch:
doc/5680-new-greeter
Type of work:
End-user documentation
Blueprint:
Starter:
Affected tool:
Greeter

Description

In several places in the new Greeter we have help buttons pointing people to the documentation. This documentation should be prepare to received each of these help buttons.

Ideally, each info button would point to a dedicated page with only the relevant information. But if we also want to have this information in the general documentation, then we need to rely on inline which are sometimes problematic. In this particular case, inlines might not be worth it and we'll instead point people to sections of the general documentation about Tails Greeter:

  • Point the info button on "Language & Region" to a new section of /doc/first_steps/startup_options right below the Greeter screenshot.
  • Remove the info button on "Encrypted Persistent Storage" because only people who already have a persistent storage would see that. It will be much more relevant once people will be able to create the persistent storage from the Greeter (#12379).
  • Point the info button on "Additional settings" to a new section of /doc/first_steps/startup_options improving on the current index of dedicated pages per settion.
  • Add a "More info" link below the paragraph describing each additional setting and pointing to :
    • /doc/first_steps/startup_options/administration_password
    • /doc/first_steps/startup_options/mac_spoofing
    • /doc/first_steps/startup_options/network_configuration
  • Hide the side bar on embeded documentation.

Related issues

Blocks Tails - Feature #12432: Technical writing core work 2017Q2 Resolved 04/07/2017

History

#1 Updated by alant almost 2 years ago

There should be 3 entry points for inline help:

  • Language & Region
  • Encrypted Persistent Storage
  • Additional Settings

#2 Updated by intrigeri almost 2 years ago

  • Target version set to Tails_3.0

I'm going to merge the new Greeter into feature/stretch, so this will become a blocker for Tails 3.0.

#3 Updated by intrigeri over 1 year ago

  • Priority changed from Normal to Elevated

#4 Updated by sajolida over 1 year ago

  • Description updated (diff)

#5 Updated by sajolida over 1 year ago

  • Description updated (diff)

#6 Updated by sajolida over 1 year ago

  • Assignee changed from sajolida to alant
  • QA Check set to Dev Needed
  • Feature Branch set to doc/5680-new-greeter

I pushed the changes we need to the documentation in doc/5680-new-greeter.

I wrote two new entry points:

  • #locale
  • #additional

The three pages for the additional settings can stay the same.

I'm assigning it to Alan for integration. Is that ok like this?

spriver should also review that but she can do that from #5680.

#7 Updated by alant over 1 year ago

Intagration should be done in feature/11949-update-doc in the greeter repository.

#8 Updated by alant over 1 year ago

  • Status changed from Confirmed to In Progress
  • Assignee changed from alant to anonym

alant wrote:

Intagration should be done in feature/11949-update-doc in the greeter repository.

I tested it works. feature/11949-update-doc should only be merged in the greeter once doc/5680-new-greeter is merged in Tails.

#9 Updated by intrigeri over 1 year ago

  • Assignee changed from anonym to spriver
  • Target version changed from Tails_3.0 to Tails_3.0~rc1
  • QA Check changed from Dev Needed to Ready for QA

Let's refocus this ticket to cover the end-user doc only, and the integration bit can be tracked on the parent ticket (or on new, sibling tickets if needed).

spriver, can you please review this?

#10 Updated by spriver over 1 year ago

  • Assignee changed from spriver to sajolida
  • QA Check changed from Ready for QA to Info Needed

I'm fine with all updates. However, some questions:

- should we use a [[!toc levels=2]] in doc/first_steps/startup_options.mdwn and then point to the relevant sections "Language & region" resp. "Additional settings" by clicking the corresponding question marks in the Greeter? (now it's pointing to the page doc/first_steps/startup_options.mdwn itself)

- is the update of doc/persistence/use.mdwn part of this ticket or will it be done somewhere else?

#11 Updated by sajolida over 1 year ago

  • Assignee changed from sajolida to spriver
  • QA Check changed from Info Needed to Ready for QA
  • I added a [[!toc levels=2]] so that it's displayed on the page. But I already had added <a id=" anchors on the pages.
  • I updated the rest of the documentation to the new Greeter (some persistence and installation pages).
  • I pointed the help desk to some tickets related to the Greeter, pointed from the Known Issues but that are closed.
  • I documented the keyboard shortcuts.

So please have a look again.

#12 Updated by sajolida over 1 year ago

#13 Updated by spriver over 1 year ago

  • Assignee changed from spriver to sajolida
  • QA Check changed from Ready for QA to Pass

Nothing to add from my side. Shortcuts are also fine for me and are working (: Good job, I like the small screenshots.
Feel free to merge! (:

#14 Updated by sajolida over 1 year ago

  • Status changed from In Progress to Resolved
  • Assignee deleted (sajolida)
  • QA Check deleted (Pass)

Merged, thanks!

#15 Updated by intrigeri over 1 year ago

  • % Done changed from 0 to 100

Also available in: Atom PDF