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

Excerpt vs description field labels are confusing #110

Open
reidab opened this issue Jun 4, 2015 · 3 comments
Open

Excerpt vs description field labels are confusing #110

reidab opened this issue Jun 4, 2015 · 3 comments

Comments

@reidab
Copy link
Member

reidab commented Jun 4, 2015

I've received several reports of confusion between the excerpt and description fields on proposals. We should relabel these to better explain how they'll be used in OCW (and, optionally, at the conference itself).

Proposal:

  • Rename excerpt to something like "blurb" or "one-sentance summary"
  • Keep description named as-is, but add additional context about expected length and usage
@stacybird
Copy link

blurb still seems ambiguous. "one-sentence-summary" seems self-explanatory. Are there any max length issues?

@wolftune
Copy link

wolftune commented Jun 5, 2015

I think Blurb (like a one or two-sentence summary) is fine. It's descriptive of the purpose without being as prescriptive as "one-sentence summary" alone. Obviously we don't actually insist on a run-on sentence versus a couple brief sentences.

The max-length issue is mostly that hovering over an item in a multi-item view is kinda bad when the "Excerpt" is really long. The other issue is that a blurb is indeed what people want when hovering rather than an excerpt.

@BartMassey
Copy link

Proposal works for me. "One-sentence summary" is probably clearer than my proposed "blurb" to some people. "Abstract" might be a suitable substitute for "Description", but maybe "Description" is clearer.

Adding a link to a brief piece about how to write a good proposal somewhere there would cover a multitude of sins. I'd be willing to write the first draft of such a piece if folks think I'm qualified.

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

4 participants