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

./zimmermann/card-sorting.md #63

Open
timm opened this issue Oct 16, 2015 · 8 comments
Open

./zimmermann/card-sorting.md #63

timm opened this issue Oct 16, 2015 · 8 comments

Comments

@timm
Copy link
Contributor

timm commented Oct 16, 2015

After review, relabel to 'reviewTwo'. After second review, relabel to 'EditorsComment'.

@kimherzig
Copy link
Contributor

Title of chapter

Card-sorting: From Text To Themes

URL to the chapter

_https://github.com/ds4se/chapters/blob/master/zimmermann/card-sorting.md _

Message?

What is the chapter's clear and approachable take away message?

Why card sorting is a easy and powerful tool to extract themes from text or surveys and how to do it.

Accessible?

Is the chapters written for a generalist audience (no excessive use of technical terminology) with a minimum of diagrams and references?
How can it be made more accessible to generalist?

Very accessible

Size?

Is the chapter the right length?

YES

Should anything missing be added?

NO

Can anything superfluous be removed (e.g. by deleting some section that does not work so well or by using less jargon, less formulae, lees diagrams, less references).?

NO

What are the aspects of the chapter that authors SHOULD change?

Nothing. I love the chapter.

Gotta Mantra?

We encouraged (but did not require) the chapter title to be a mantra or something cute/catchy, i.e., some slogan reflecting best practice for data science for SE? If you have suggestion for a better title, please put them here.

??

Best Points

What are the best points of the chapter that the authors should NOT change?

I simply love the chapter. It presents a powerful idea that tackles a frequent problem and it hand-on. Now I know how to do it. Thanks Tom.

@migod
Copy link
Contributor

migod commented Dec 7, 2015

Title of chapter

Card-sorting: From Text To Themes

URL to the chapter

https://github.com/ds4se/chapters/blob/master/zimmermann/card-sorting.md

Message?

Card sorting is a useful, simple, and low-tech way to categorize plain text data and recognize emerging themes.

Accessible?

Overall, it is very accessible.

Size?

Maybe add another paragraph or so to the analysis phase section, since this is where the payoff is and where you are trying to sell the usefulness of the technique. Can you put the results into a larger context?

Gotta Mantra?

It's a good title

Best Points

The topic is great! It demystifies something very useful and powerful through a simple explanation. I especially liked how you said which tools you used and how. I think anyone could take this information and go do a card sort right after reading it.

Nits, wording suggestions, etc.

"open text question"
-- What is an open text question, and how is this different from a plain old question? Maybe it would be helpful to give an example question here, like "What problems are stopping us from meeting our deadlines?"

"card identifier"
-- Do you mean a unique label? A non-CS person might not understand what you mean. Can you give a simple example of an identifier and its later use?

@prechelt
Copy link
Contributor

prechelt commented Dec 8, 2015

"affinity diagrams" (near the end) should have a reference.

@timm
Copy link
Contributor Author

timm commented Dec 23, 2015

Can we add anything about the overall time required for these sorts?

Any "home run" stories? great core wonderful insights that BLEW everyone away?

@tzimmermsr
Copy link
Contributor

Thanks everyone for the great feedback. I changed the chapter as follows:

  • Rewrote the first paragraph to explain open-ended questions (@migod)
  • Expanded the analysis section (@migod). Some parts from the preparation phase fit better in the analysis section
  • Explained identifiers (@migod)
  • Added citation for affinity diagrams (@prechelt)

@timm: The execution phase has something about the time.

@timm
Copy link
Contributor Author

timm commented Feb 7, 2016

thanks @tzimmermsr : this is good to go.... once we get that photo of a card sort

@tzimmermsr
Copy link
Contributor

Working on it now.

From: Tim Menzies [mailto:[email protected]]
Sent: Sunday, February 7, 2016 2:01 PM
To: ds4se/chapters [email protected]
Cc: Tom Zimmermann [email protected]
Subject: Re: [chapters] ./zimmermann/card-sorting.md (#63)

thanks @tzimmermsrhttps://github.com/tzimmermsr : this is good to go.... once we get that photo of a card sort


Reply to this email directly or view it on GitHubhttps://github.com//issues/63#issuecomment-181131198.

@tzimmermsr
Copy link
Contributor

@timm I've uploaded the picture. Please mark as Good to Go.

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

No branches or pull requests

5 participants