10
\$\begingroup\$

Our FAQ has become quite cluttered and convoluted. There are many issues with it, but among the most pressing I currently see:

  • There are 3 questions about recommendation questions, which is a mess. We might want to have one that covers all those types and points to specific sub-types of why those are banned.
  • 2 different FAQs on Frame Challenge. Again, unifying them into a top one and branch from there seems to be in order.
  • The Editing section might need serious updates, as we got multiple tools since all those in there were written.
  • We have three FAQs that concern spam and trolls... Might we cut those to one somehow?
  • Several of the FAQs are linking to a later part in a series of discussions, which makes them appear misplaced... as trivial.

All these issues might need to be addressed separately, but in general, it seems housekeeping is in order. For some of these issues, writing a special new might be the best way to get the best of two worlds - retaining the old discussions and questions as well as incorporating the current stance on topics where it has changed due to the realities of the stack changing.

\$\endgroup\$
11
  • \$\begingroup\$ @ThomasMarkov The tag was deliberate and a suggestion by SevenSidedDie - because this is not a proposal in the sense that items on the Maintenance shall not become an FAQ but that it is to handle the FAQ, such as removal of points, workshopping on a canonical FAQ or whatever else is needed. \$\endgroup\$
    – Trish
    Feb 5, 2023 at 1:23
  • \$\begingroup\$ The faq proposal index post is also not a faq proposal yet it has the tag…because it is about managing the faq. There is no reason to have a faq management tag when we already have a tag for managing and making proposals about the faq. \$\endgroup\$ Feb 5, 2023 at 1:41
  • \$\begingroup\$ @ThomasMarkov please note the bracket here suggesting exactly that tag. \$\endgroup\$
    – Trish
    Feb 5, 2023 at 2:19
  • \$\begingroup\$ I don't think it's unreasonable, for frame-challenges (or any particular jargon topic) to have separate "What is it?" and "How do we do it here?" entries. I don't feel strongly about it. If we do, I will volunteer to write something up for consideration. \$\endgroup\$
    – Novak
    Feb 5, 2023 at 22:14
  • 5
    \$\begingroup\$ Potentially unpopular opinion: I think it's worth revisiting the ban on recommendation questions instead of just cleaning the FAQ. I understand and at one time agreed with that reasoning behind the ban. Based on experience in other stacks, I increasingly disagree. \$\endgroup\$
    – Novak
    Feb 5, 2023 at 22:16
  • 1
    \$\begingroup\$ FWIW, I've actioned some of the clear FAQs from the proposal index and also added all outstanding proposals. Once there has been some voting on those I will action the rest. \$\endgroup\$
    – linksassin Mod
    Feb 7, 2023 at 3:59
  • 2
    \$\begingroup\$ @Novak: Given that the ban was put in place before I was even active on the site, I do think it's worth discussing, at the least – the community now isn't necessarily the same as the community when it was put in place. Even if the community decides to keep some or all of the ban in place, I think there is value in having that discussion again (as long as the discussion remains respectful and understanding). \$\endgroup\$
    – V2Blast
    Feb 7, 2023 at 19:08
  • \$\begingroup\$ @V2Blast I was coming to the same conclusion. Going to mull what I want to say until (at least) the weekend, when I will have the time to put effort into a longer post. \$\endgroup\$
    – Novak
    Feb 8, 2023 at 2:02
  • \$\begingroup\$ @Novak I like the idea of putting forth one update question, which then encompasses all recommendation questions and replaces them on the FAQ. \$\endgroup\$
    – Trish
    Feb 8, 2023 at 8:43
  • 1
    \$\begingroup\$ @Trish Updating and polishing sections of the FAQ is quite different from a major modification of site policy. \$\endgroup\$
    – Novak
    Feb 8, 2023 at 23:55
  • \$\begingroup\$ @Novak identifying the need for it is part of maintenance. \$\endgroup\$
    – Trish
    Feb 9, 2023 at 9:09

5 Answers 5

4
\$\begingroup\$

Frame Challenge FAQ

We have What's a frame challenge? and How do we handle a desire to challenge the frame of a question?

Both of them are last updated in 2018 and 2019 respectively, so might warrant a look if everything is still ok. They are very close to one another in topic and might or might not need a slight touchup.

As far as the FAQ page goes, at least they are listed in the wrong order on the FAQ (definition after use), and the use example might benefit from being indented as a lvl-2 bullet point.

Relevant discussion

I don't think it's unreasonable, for frame-challenges (or any particular jargon topic) to have separate "What is it?" and "How do we do it here?" entries. I don't feel strongly about it. If we do, I will volunteer to write something up for consideration. – Novak Feb 5 at 22:14

\$\endgroup\$
1
  • 2
    \$\begingroup\$ Hmm, I just read them both. From a first time reader, the overlap of the two does seem pretty strong, and in this case merging them to "What is it and how/when to use" would be pretty simple/efficient IMO. \$\endgroup\$
    – Alan
    Feb 17, 2023 at 8:30
4
\$\begingroup\$

part X in titles -

These had a part number in the title. We might want to rename them to a year of when the consensus came along, removing clarity problems from the previous items.

\$\endgroup\$
1
  • \$\begingroup\$ Due to how trivial this fix was, I did this just now. Just editing the FAQ without altering anything will update the text there \$\endgroup\$
    – Trish
    Feb 19, 2023 at 16:28
1
\$\begingroup\$

Trolls and canned meat (SPAM)

We got at least two questions on those (I thought it was three a few days ago...):

Both might need a touchup, for example how to deal with a serious returning troll.

Joinder of those two seems very hard, but if someone is up to the challenge, it could shorten the FAQ a tad.

\$\endgroup\$
1
\$\begingroup\$

Recommendation Questions

Apparently, recommendation questions need a total revisit - Is that still the stance of the stack? At least 5 people voted on a comment to the opener, that they'd like to discuss the topic of topicality.

All of these have different nuances, the stance might be outdated on some points. A standalone question should be asked:

Are Recommendation Questions on Topic? [2023]

relevant discussion:

5 - Potentially unpopular opinion: I think it's worth revisiting the ban on recommendation questions instead of just cleaning the FAQ. I understand and at one time agreed with that reasoning behind the ban. Based on experience in other stacks, I increasingly disagree. – Novak Feb 5 at 22:16

1 - FWIW, I've actioned some of the clear FAQs from the proposal index and also added all outstanding proposals. Once there has been some voting on those I will action the rest. – linksassin Mod Feb 7 at 3:59

2 - @Novak: Given that the ban was put in place before I was even active on the site, I do think it's worth discussing, at the least – the community now isn't necessarily the same as the community when it was put in place. Even if the community decides to keep some or all of the ban in place, I think there is value in having that discussion again (as long as the discussion remains respectful and understanding). – V2Blast Staff Mod 2 days ago

@V2Blast I was coming to the same conclusion. Going to mull what I want to say until (at least) the weekend, when I will have the time to put effort into a longer post. – Novak 2 days ago

@Novak I like the idea of putting forth one update question, which then encompasses all recommendation questions and replaces them on the FAQ. – Trish 2 days ago

@Trish Updating and polishing sections of the FAQ is quite different from a major modification of site policy. – Novak yesterday

@Novak identifying the need for it is part of maintenance. – Trish yesterday

\$\endgroup\$
1
  • 5
    \$\begingroup\$ This seems like one the mods may want to handle as far as question framing and scoping the discussion. \$\endgroup\$ Feb 8, 2023 at 13:17
1
\$\begingroup\$

The Editing Section

At the very least, the order of the points in the Editing section is convoluted. I propose the following re-order, pretty much sorting from top level "style in general" over "specific points"

\$\endgroup\$
3
  • 5
    \$\begingroup\$ "I haven't seen a single edit in text in a long time" Likely because myself and others are swift to edit them out. I see them several times a week. \$\endgroup\$ Feb 8, 2023 at 13:18
  • \$\begingroup\$ @ThomasMarkov I didn't say it doesn't happen, but that it is less useful than the format items. \$\endgroup\$
    – Trish
    Feb 8, 2023 at 13:21
  • 1
    \$\begingroup\$ I had to be trained out of the edit habit here....I do agree that it's a policy that A: People who will need to be informed aren't likely to have read the FAQ first about it and B: The correction from a mod is very clear and didn't take me any "Let's read a FAQ for details as to what they are saying here." So yeah, putting it at the very end of the FAQ makes sense to me \$\endgroup\$
    – Alan
    Feb 17, 2023 at 8:37

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .