diff --git a/docs/source/01-05-pre-launch-checklist.md b/docs/source/01-05-pre-launch-checklist.md index 73432bc02..3f094a654 100644 --- a/docs/source/01-05-pre-launch-checklist.md +++ b/docs/source/01-05-pre-launch-checklist.md @@ -77,7 +77,8 @@ permalink: /pre-launch-checklist/ - See [our blog for more information](https://coralproject.net/blog/slacking-on/) -- [ ] Has your community team configured Talk to match your community strategy? +- [ ] Have you configured Talk’s admin settings and determined your community strategy? - See [our tutorial for more information](https://docs.coralproject.net/talk/when-youve-installed-talk/) + - See [Configuring Talk](/talk/configuring-talk/) diff --git a/docs/source/02-03-cli-tools.md b/docs/source/02-03-cli-tools.md index 5d5df0864..7601bc907 100644 --- a/docs/source/02-03-cli-tools.md +++ b/docs/source/02-03-cli-tools.md @@ -81,12 +81,17 @@ Usage: cli-assets [options] [command] Commands: list [options] list all the assets in the database + debug prints the scraped metadata from that URL refresh [age] queues the assets that exceed the age requested update-url update the URL of an asset merge merges two assets together by moving comments from src to dst and deleting the src asset rewrite [options] rewrites asset url's using the provided regex replacement pattern ``` +When using the `refresh` command, the `age` value specifies how far back in time to re-scrape assets; i.e. to re-scrape everything that was scraped in the last week use `1w` or `7d`. Supports ms (milliseconds), s (seconds), m (minutes), h (hours), d (days) and w (weeks). Assets that have not been scraped will also be queued for scraping. + +See also, [Asset Scraping](/talk/integrating/asset-scraping/) for more details about asset scraping. + ## Setting up the application You can also run a setup wizard to setup the wizard using `./bin/cli setup`. Below is a list of additional options available for this command: ``` diff --git a/docs/source/03-06-product-guide-configuring-talk.md b/docs/source/03-06-product-guide-configuring-talk.md index c38e59aed..d748f3688 100644 --- a/docs/source/03-06-product-guide-configuring-talk.md +++ b/docs/source/03-06-product-guide-configuring-talk.md @@ -57,7 +57,7 @@ The timeframe in seconds in which commenters have to edit their comment. #### Close Comments After -Default time after which all comment streams will close. +Default time after which all comment streams will close. Applies to assets created in Talk after this configuration is saved, and does not update existing assets. ### Moderation Settings diff --git a/docs/source/05-03-when-youve-installed-talk.md b/docs/source/05-03-when-youve-installed-talk.md index b4eec585c..f6595b8ad 100644 --- a/docs/source/05-03-when-youve-installed-talk.md +++ b/docs/source/05-03-when-youve-installed-talk.md @@ -87,6 +87,8 @@ The most important predictors of the success of an online community are: #### Effectively +* Keep conversations fresh and reduce moderation overhead by configuring Talk to automatically close commenting after a specified time window. Should comments be open for a day, a week, or a month? Set a manageable window and automatically close stories for commenting after that time period. + * If you're using the Toxic Comments plugin, make sure that its threshold is set at the level that catches most comments with fewest false positives (default is 80%). You can see the Likely to be Toxic level of every comment by clicking "More Details" on the comment card in the moderation view. * Publicly discourage behavior in the comments that doesn't cross the line but suggests that the tone or focus could shift quickly in a direction you don't want. Point to relevant sections of your community guidelines. [Read more about defining and discouraging this kind of behavior here.](https://guides.coralproject.net/manage-a-successful-community/) diff --git a/docs/source/integrating/asset-scraping.md b/docs/source/integrating/asset-scraping.md index 5d524f062..956808311 100644 --- a/docs/source/integrating/asset-scraping.md +++ b/docs/source/integrating/asset-scraping.md @@ -9,6 +9,9 @@ in a simple way. We use the following [meta tags](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta) on the target pages that allow us to extract some properties. +Asset scraping is performed by the `scraper` job which is enabled by default when you launch Talk. If your production site is behind a paywall or otherwise prevents scraping, you might need to confiugre a [TALK_SCRAPER_PROXY_URL](/talk/advanced-configuration/#talk-scraper-proxy-url) or custom [TALK_SCRAPER_HEADERS](/talk/advanced-configuration/#talk-scraper-headers). + + | Asset Property | Selector | |--------------------|----------| | `title` | See [`metascraper-title`](https://github.com/microlinkhq/metascraper/blob/dc664c37ea1b238b1e3e9d5342edfacc9027892c/packages/metascraper-title/index.js) | @@ -19,7 +22,7 @@ the target pages that allow us to extract some properties. | `modified_date` | `meta[property="article:modified"]` | | `section` | `meta[property="article:section"]` | -You can use the `./bin/cli assets debug ` to print the scraped metadata +You can use the `./bin/cli assets debug ` command to print the scraped metadata from that URL. For example: ```bash @@ -41,4 +44,8 @@ from that URL. For example: ├──────────────────┼──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤ │ section │ │ └──────────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ -``` \ No newline at end of file +``` + + + +You can use the `./bin/cli assets refresh [age]` to trigger scraping or rescrape assets where the scraper job was unsuccessful. \ No newline at end of file diff --git a/plugins/talk-plugin-profile-data/server/typeDefs.graphql b/plugins/talk-plugin-profile-data/server/typeDefs.graphql index 62e27cae4..19967e013 100644 --- a/plugins/talk-plugin-profile-data/server/typeDefs.graphql +++ b/plugins/talk-plugin-profile-data/server/typeDefs.graphql @@ -41,7 +41,7 @@ type CancelAccountDeletionResponse implements Response { errors: [UserError!] } -# DownloadUserResponse contaisn the account download archiveURL that can be used +# DownloadUserResponse contains the account download archiveURL that can be used # to directly download a zip file containing the user data. type DownloadUserResponse implements Response {