mcPear commited on
Commit
568c6a8
·
1 Parent(s): 41d5309

chore: organise 'substantial guidleines' section

Browse files
Files changed (1) hide show
  1. app.py +14 -30
app.py CHANGED
@@ -53,55 +53,39 @@ st.checkbox(
53
  "Why the story matters to a reader?"
54
  ) # TODO does examplary headlines really answer that? maybe in sub-headlines, I don't get it but looks important, read more
55
 
56
- st.write("**Make sure the headline is:**")
57
 
58
- ### interesting
59
- st.checkbox("focused on what is most interesting")
60
- # Is it interesting? Make it interesting
61
  st.checkbox(
62
- "Focus on what’s interesting.",
63
- help="Be straightforward about why a reader should read the article. Don’t bury or hide this.",
64
  )
65
- # Focus on what’s interesting. Your headline doesn’t need to address everything that’s in your story.
66
- # It just needs to focus on the most interesting part of your story in a way that represents the overall truth of your story.
67
- ### interesting
68
 
69
- st.checkbox( # (trait or individual style?)
70
- "Direct",
71
  help="Your story is among many a reader is browsing. Be straightforward in what it is about.",
72
  )
73
- "How To Become Popular Without Being Charming, Funny, or Outgoing"
74
- "How Google Earth Mapped 98% of the World"
75
 
76
- st.checkbox( # TODO it's optional depending on the audience
77
- "Uses conventional language (if for a general audience)",
78
- help="Avoid jargon, and think of what makes sense in casual conversation. Know the language that your audience is familiar with.",
79
- )
80
  st.checkbox(
81
- "**Deliver on your promises**",
82
  help="You’re building a relationship with your readers. The headline sets the expectations, and the story must deliver on that.",
83
  )
 
84
  st.checkbox(
85
  "Don’t ask a question unless you know the answer",
86
- help="You’re building a relationship with your readers. The headline sets the expectations, and the story must deliver on that.",
87
  )
 
88
  st.checkbox(
89
- "If you want to be poetic or clever in your headline, follow it up with a strong subheadline",
90
- help="You may want to be poetic, clever, or artistic in the title. The challenge with crafting a title this way is that it becomes opaque. It’s also much easier to write a bad title when striving for something poetic or clever than if you’re going for clarity. In most cases, the reader won’t click to find out more because they didn’t understand what the story was about in the first place.",
91
  )
92
 
93
- st.write("**Guiding questions to consider:**")
94
  st.checkbox(
95
- "Make it clear. Could the headline be clearer?"
96
- ) # there is such type (is it rule along others or individual style)
97
- st.checkbox("Is the headline specific enough?")
98
- st.checkbox("Does the tone reflect the voice or point of view of the article?")
99
- st.checkbox("How might the headline convey what is unique about the story?")
100
- st.checkbox(
101
- "Is it true? Make it true. Don't overpromise. Is the headline honest about what the story offers the reader?"
102
  )
103
 
104
- # TODO most of them below are extras/obvious
105
  st.checkbox("profanity")
106
  st.checkbox("exaggeration")
107
  st.checkbox("mystery")
 
53
  "Why the story matters to a reader?"
54
  ) # TODO does examplary headlines really answer that? maybe in sub-headlines, I don't get it but looks important, read more
55
 
56
+ st.write("**Moreover:**")
57
 
 
 
 
58
  st.checkbox(
59
+ "Focus on what is interesting",
60
+ help="Your headline doesn’t need to address everything that’s in your story. It just needs to focus on the most interesting part of your story in a way that represents the overall truth of your story.",
61
  )
 
 
 
62
 
63
+ st.checkbox(
64
+ "Make it direct and clear",
65
  help="Your story is among many a reader is browsing. Be straightforward in what it is about.",
66
  )
 
 
67
 
 
 
 
 
68
  st.checkbox(
69
+ "Deliver on your promises",
70
  help="You’re building a relationship with your readers. The headline sets the expectations, and the story must deliver on that.",
71
  )
72
+
73
  st.checkbox(
74
  "Don’t ask a question unless you know the answer",
75
+ help="Same as above",
76
  )
77
+
78
  st.checkbox(
79
+ "Use conventional language (if you write for a general audience)",
80
+ help="Avoid jargon, and think of what makes sense in casual conversation. Know the language that your audience is familiar with.",
81
  )
82
 
 
83
  st.checkbox(
84
+ "If you want to be poetic or clever in your headline, follow it up with a strong subheadline",
85
+ help="You may want to be poetic, clever, or artistic in the title. The challenge with crafting a title this way is that it becomes opaque. It’s also much easier to write a bad title when striving for something poetic or clever than if you’re going for clarity. In most cases, the reader won’t click to find out more because they didn’t understand what the story was about in the first place.",
 
 
 
 
 
86
  )
87
 
88
+ st.write("**Avoid:**")
89
  st.checkbox("profanity")
90
  st.checkbox("exaggeration")
91
  st.checkbox("mystery")