Opened 9 years ago

Closed 8 years ago

#3539 task closed fixed (fixed)

Drop all FAQs in the repository and merge them into the wiki FAQ page

Reported by: Thijs Triemstra Owned by:
Priority: normal Milestone:
Component: core Keywords: documentation
Cc: Thijs Triemstra Branch: branches/drop-faqs-3539
branch-diff, diff-cov, branch-cov, buildbot
Author: thijs

Description (last modified by Jean-Paul Calderone)

We've stopped maintaining FAQs in the repository. Instead, we maintain one on the wiki - FrequentlyAskedQuestions. Some subprojects still have FAQs, though. We should remove them from the repository and put them onto the wiki.

Change History (13)

comment:1 Changed 9 years ago by Thijs Triemstra

Cc: Thijs Triemstra added
Owner: changed from Glyph to Thijs Triemstra
Status: newassigned
Summary: Distribute the wiki's FAQ with new releasesDrop all FAQs in the repository and merge them into the wiki FAQ page
Type: regressiontask

Renamed the ticket description based on the IRC chat, pasted below:

[14:46] exarkun: thijs: How about we don't distribute the FAQ?
[14:47] thijs: what about the t.web faq.. then we should get rid of that one as well, merge it into the wiki page?
[14:48] exarkun: probably
[14:48] thijs: exarkun: sounds good not to distribute it, but lets not make an exception for any other faqs in doc/ ?
[14:48] thijs: ok
[14:48] exarkun: I would just throw away the woven faq entries, though.
[14:49] thijs: ill rename the ticket to drop any other faqs and merge them into the wiki, except for woven

comment:2 Changed 9 years ago by Jean-Paul Calderone

Description: modified (diff)

The old description was:

Now that the core FAQ isn't maintained in the Subversion repository anymore (it was dropped with #3236), we could export the wiki's FrequentlyAskedQuestions page and include it in new releases.

comment:3 Changed 8 years ago by Thijs Triemstra

Author: thijs
Branch: branches/drop-faqs-3539

(In [26505]) Branching to 'drop-faqs-3539'

comment:4 Changed 8 years ago by Thijs Triemstra

Some entries I'm moving from [source:doc/web/howto/faq.xhtml] to FrequentlyAskedQuestions:


Can Twisted Web do PHP?

Yes. It works out-of-the-box, so long as you've got the standalone PHP interpreter installed.

And can Twisted Web do virtual hosting?

You can decide to go with one big process for all of them, a front server and a seperate server for each virtual host (for example, for permission reasons), and you can even mix-and-match between Apache and Twisted (for example, put Apache in the front and have Twisted handle some subset of the virtual host).

comment:5 Changed 8 years ago by Thijs Triemstra

(In [26506]) Drop web faq, refs #3539

comment:6 Changed 8 years ago by Thijs Triemstra

Keywords: review added
Owner: Thijs Triemstra deleted
Status: assignednew

Putting the branch and items from comment 4 in this ticket up for review.

comment:7 Changed 8 years ago by Thijs Triemstra

doc builder is happy as well.

comment:8 Changed 8 years ago by Jean-Paul Calderone

Keywords: review removed
Owner: set to Thijs Triemstra

Where'd the web faq entries go? Did they just get deleted? I looked for them on the FrequentlyAskedQuestions page but did not see them. And I don't see a dedicated Web FAQ page.

comment:9 in reply to:  8 Changed 8 years ago by Thijs Triemstra

Keywords: review added
Owner: changed from Thijs Triemstra to Jean-Paul Calderone

Replying to exarkun:

Where'd the web faq entries go? Did they just get deleted? I looked for them on the FrequentlyAskedQuestions page but did not see them. And I don't see a dedicated Web FAQ page.

I only found 2 entries from that FAQ that seemed helpful. They're listed in comment 4 of this ticket. Since there are only 2 entries I don't think it's necessary to create a dedicated FAQ page for web. Putting it up for review, let me know your thoughts, cheers.

comment:10 Changed 8 years ago by Jean-Paul Calderone

Keywords: review removed
Owner: changed from Jean-Paul Calderone to Thijs Triemstra

I think it's fine to create a FAQ with just two entries on it. It'll grow more entries eventually. :) So if you agree, go ahead and create a FAQ for those and merge the branch.

comment:11 Changed 8 years ago by Thijs Triemstra

Status: newassigned

comment:12 Changed 8 years ago by Thijs Triemstra

Resolution: fixed
Status: assignedclosed

(In [26589]) Merge drop-faqs-3539: drop the last faq in the repository and merge it into the TwistedWeb/FrequentlyAskedQuestions wiki page.

Author: thijs Reviewer: exarkun Fixes: #3539

comment:13 Changed 6 years ago by <automation>

Owner: Thijs Triemstra deleted
Note: See TracTickets for help on using tickets.