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

Review User Documentation (Trac #514) #647

Closed
butlerpd opened this issue Mar 30, 2019 · 3 comments
Closed

Review User Documentation (Trac #514) #647

butlerpd opened this issue Mar 30, 2019 · 3 comments
Labels
Documentation Concerns documentation Enhancement Feature requests and/or general improvements Major Big change in the code or important change in behaviour

Comments

@butlerpd
Copy link
Member

butlerpd commented Mar 30, 2019

The User documentation needs to be reviewed for the following:

  • readability
  • does it match the actual functionality (does pressing the button do what it says)

Probably best to do as with models and establish a table of sections to be reviewed with a name assignment and done checkbox column

Migrated from http://trac.sasview.org/ticket/514

{
    "status": "closed",
    "changetime": "2019-03-26T12:57:51",
    "_ts": "2019-03-26 12:57:51.926479+00:00",
    "description": "The User documentation needs to be reviewed for the following:\n * readability\n * does it match the actual functionality (does pressing the button do what it says)\n\nProbably best to do as with models and establish a table of sections to be reviewed with a name assignment and done checkbox column",
    "reporter": "butler",
    "cc": "",
    "resolution": "obsolete",
    "workpackage": "SasView Documentation",
    "time": "2016-03-15T17:11:28",
    "component": "SasView",
    "summary": "Review User Documentation",
    "priority": "major",
    "keywords": "",
    "milestone": "SasView Next Release +1",
    "owner": "",
    "type": "enhancement"
}
@butlerpd butlerpd added this to the SasView Next Release +1 milestone Mar 30, 2019
@butlerpd butlerpd added Enhancement Feature requests and/or general improvements Incomplete Migration Major Big change in the code or important change in behaviour Documentation Concerns documentation and removed Incomplete Migration labels Mar 30, 2019
@butlerpd
Copy link
Member Author

Trac update at 2019/03/23 14:53:51: butler commented:

can we close this ticket? It was generated a long time ago when the rst documentation was still being worked on developed. In some sense this is an unclosable ticket as it will always need doing better, but at this point the docs are pretty complete and even "hefty" and I think we have essentially done what this was intended for and it is unlikely anyone will have the bandwidth to systematically go over everything again?

@smk78
Copy link
Contributor

smk78 commented Mar 30, 2019

Trac update at 2019/03/26 12:56:40: smk78 commented:

I agree. I think at this juncture any specific issues with the user documentation should be the subject of specific tickets. I am therefore closing this one.

@smk78
Copy link
Contributor

smk78 commented Mar 30, 2019

Trac update at 2019/03/26 12:57:51:

  • smk78 changed resolution from "" to "obsolete"
  • smk78 changed status from "new" to "closed"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Documentation Concerns documentation Enhancement Feature requests and/or general improvements Major Big change in the code or important change in behaviour
Projects
None yet
Development

No branches or pull requests

2 participants