Skip to content

Updating Community Management Discord, Telegram, & X (Twitter) Guides.mdx#514

Closed
NFTDreww wants to merge 6 commits into
security-alliance:developfrom
NFTDreww:develop
Closed

Updating Community Management Discord, Telegram, & X (Twitter) Guides.mdx#514
NFTDreww wants to merge 6 commits into
security-alliance:developfrom
NFTDreww:develop

Conversation

@NFTDreww

@NFTDreww NFTDreww commented Jun 2, 2026

Copy link
Copy Markdown
Collaborator

I have updated the overall update overview to be more inline with the feedback given over the past few weeks, which were:

Reframe the intro as a wayfinding statement. Instead of opening with a content summary, open with a one- or two-sentence orientation about what community security covers and where to go. Something like: "Community Management security spans several disciplines — each with its own dedicated Framework. Use this page to find the right one."

Convert the best practices section into a visual index. Each of the four sections (2FA/passwords, phishing, OpSec, emergency response) already has a corresponding Framework, so we can turn them into explicit cards or a linked table with the topic, a single descriptive sentence, and the link. This keeps the content without making it feel like a dead end.

Cut the inline detail that lives somewhere else. For example, TOTP configuration advice, the password manager separation rule, and the DM-first policy all belong in the destination frameworks, not here. Keeping it here creates both a maintenance burden for your team and dilutes the "go there for more" message.

------------------------------------------------------------------------ Therefore I was able to make the community manage guides more of the why, what, and how/where? Explaining this information and then leading into the actual frameworks for each that ALL needs to be taken into consideration when talking about community management and it's subsequent guides/frameworks.

This included a complete reformat of the Discord page, that I think addresses all feedback and has a cleaner flow to providing the north star for this section.

Frameworks PR Checklist

Thank you for contributing to the Security Frameworks! Before you open a PR, make sure to read information for contributors and take a look at the following checklist:

  • Describe your changes, substitute this text with the information
  • If you are touching an existing piece of content, tag current contributors from the attribution list
  • If there is a steward for that framework, ask the steward to review it
  • If you're modifying the general outline, make sure to update it in the vocs.config.ts adding the dev: true parameter
  • If you need feedback for your content from the wider community, share the PR in our Discord
  • Review changes to ensure there are no typos; see instructions below.

NFTDreww added 3 commits June 2, 2026 10:45
I have updated the overall update overview to be more inline with the feedback given over the past few weeks, which were:

Reframe the intro as a wayfinding statement. Instead of opening with a content summary, open with a one- or two-sentence orientation about what community security covers and where to go. Something like: "Community Management security spans several disciplines — each with its own dedicated Framework. Use this page to find the right one."

Convert the best practices section into a visual index. Each of the four sections (2FA/passwords, phishing, OpSec, emergency response) already has a corresponding Framework, so we can turn them into explicit cards or a linked table with the topic, a single descriptive sentence, and the link. This keeps the content without making it feel like a dead end.

Cut the inline detail that lives somewhere else. For example, TOTP configuration advice, the password manager separation rule, and the DM-first policy all belong in the destination frameworks, not here. Keeping it here creates both a maintenance burden for your team and dilutes the "go there for more" message.

------------------------------------------------------------------------ Therefore I was able to make the community manage guides more of the why, what, and how/where? Explaining this information and then leading into the actual frameworks for each that ALL needs to be taken into consideration when talking about community management and it's subsequent guides/frameworks.

This included a complete reformat of the Discord page, that I think addresses all feedback and has a cleaner flow to providing the north star for this section.
I have updated the overall update overview to be more inline with the feedback given over the past few weeks, which were:

Reframe the intro as a wayfinding statement. Instead of opening with a content summary, open with a one- or two-sentence orientation about what community security covers and where to go. Something like: "Community Management security spans several disciplines — each with its own dedicated Framework. Use this page to find the right one."

Convert the best practices section into a visual index. Each of the four sections (2FA/passwords, phishing, OpSec, emergency response) already has a corresponding Framework, so we can turn them into explicit cards or a linked table with the topic, a single descriptive sentence, and the link. This keeps the content without making it feel like a dead end.

Cut the inline detail that lives somewhere else. For example, TOTP configuration advice, the password manager separation rule, and the DM-first policy all belong in the destination frameworks, not here. Keeping it here creates both a maintenance burden for your team and dilutes the "go there for more" message.

------------------------------------------------------------------------ Therefore I was able to make the community manage guides more of the why, what, and how/where? Explaining this information and then leading into the actual frameworks for each that ALL needs to be taken into consideration when talking about community management and it's subsequent guides/frameworks.

This included a complete reformat of the Discord page, that I think addresses all feedback and has a cleaner flow to providing the north star for this section.
I have updated the overall update overview to be more inline with the feedback given over the past few weeks, which were:

Reframe the intro as a wayfinding statement. Instead of opening with a content summary, open with a one- or two-sentence orientation about what community security covers and where to go. Something like: "Community Management security spans several disciplines — each with its own dedicated Framework. Use this page to find the right one."

Convert the best practices section into a visual index. Each of the four sections (2FA/passwords, phishing, OpSec, emergency response) already has a corresponding Framework, so we can turn them into explicit cards or a linked table with the topic, a single descriptive sentence, and the link. This keeps the content without making it feel like a dead end.

Cut the inline detail that lives somewhere else. For example, TOTP configuration advice, the password manager separation rule, and the DM-first policy all belong in the destination frameworks, not here. Keeping it here creates both a maintenance burden for your team and dilutes the "go there for more" message.

------------------------------------------------------------------------ Therefore I was able to make the community manage guides more of the why, what, and how/where? Explaining this information and then leading into the actual frameworks for each that ALL needs to be taken into consideration when talking about community management and it's subsequent guides/frameworks.

This included a complete reformat of the Discord page, that I think addresses all feedback and has a cleaner flow to providing the north star for this section.
@NFTDreww NFTDreww changed the title Update discord.mdx Updating Discord, Telegram, & X (Twitter) Guides.mdx Jun 2, 2026
@NFTDreww NFTDreww changed the title Updating Discord, Telegram, & X (Twitter) Guides.mdx Updating Community Management Discord, Telegram, & X (Twitter) Guides.mdx Jun 2, 2026

@frameworks-volunteer frameworks-volunteer left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Model: z-ai/glm-5.2 Reasoning: medium Provider: openrouter

Security review: no issues found. No secrets, no injection vectors, no unsafe content. All links point to the official frameworks.securityalliance.dev domain. MDX is static content with no dynamic input.

QA review -- content aligns well with the PR description (wayfinding intros, visual index tables, cut inline detail). A few minor inconsistencies to address:

  1. TagList component removed from discord.mdx but kept in telegram.mdx and twitter.mdx. All three pages should be consistent -- either keep TagList on all or remove from all.

  2. Contributors not updated in twitter.mdx. NFTDreww was added to the wrote role in discord.mdx and telegram.mdx but not in twitter.mdx, despite content changes to that file.

  3. "screenshot" (discord.mdx, line in risk table) vs "screenshotted" (twitter.mdx, same context). Pick one form for consistency.

  4. Telegram.mdx: "two-step verification and phone number privacy in particular; take under five minutes" -- the semicolon should be a comma or em-dash, not a semicolon.

  5. Links changed from relative paths (/guides/account-management/discord) to absolute URLs (https://frameworks.securityalliance.dev/guides/account-management/discord). This works but breaks the pattern used by the original files and other pages in the repo. Consider keeping relative paths for internal links.

None of these are blocking. The content itself is well-structured and security-appropriate.

@mattaereal mattaereal marked this pull request as ready for review June 29, 2026 14:49
@github-actions

github-actions Bot commented Jun 29, 2026

Copy link
Copy Markdown
built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
frameworks ✅ Ready (View Log) Visit Preview f8147cd

@scode2277

scode2277 commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

@NFTDreww for my understanding this is a duplication of the #513 with the only addition of the twitter file, am i right?

If yes, can you please add that file there as i've already made a lot of changes regarding the files structure and it would be a repetition here.

Thanks!🙏🏻

If we can make the #513 merge today or tomorrow, these updated will be into our monthly update of the .org site :)

@frameworks-volunteer

Copy link
Copy Markdown
Collaborator

Model: z-ai/glm-5.2 Reasoning: medium Provider: openrouter

@scode2277 Confirmed — I compared both diffs and #514 is largely a duplicate of #513 for discord.mdx and telegram.mdx, with twitter.mdx as the only net-new file.

File overlap:

The discord and telegram content is substantively the same across both PRs (same risk tables, topic indexes, community manager sections), but there are divergences that would need resolving if consolidating:

  1. Links: Update Overview Community Management Guide.mdx #513 uses relative paths (/guides/account-management/discord), Updating Community Management Discord, Telegram, & X (Twitter) Guides.mdx #514 uses absolute URLs (https://frameworks.securityalliance.dev/...). Update Overview Community Management Guide.mdx #513's relative links are consistent with the rest of the repo.
  2. AttributionList: Update Overview Community Management Guide.mdx #513 adds the AttributionList import and <AttributionList> component; Updating Community Management Discord, Telegram, & X (Twitter) Guides.mdx #514 does not.
  3. Contributor casing: Update Overview Community Management Guide.mdx #513 uses nftdreww, Updating Community Management Discord, Telegram, & X (Twitter) Guides.mdx #514 uses NFTDreww in the frontmatter.
  4. Updating Community Management Discord, Telegram, & X (Twitter) Guides.mdx #514 adds a "Spotted an error or have ideas..." line before the closing guide link that Update Overview Community Management Guide.mdx #513 does not have.

Recommendation: agree with consolidating into #513. If @NFTDreww moves the twitter.mdx changes to #513 (matching #513's conventions: relative links, AttributionList, lowercase contributor handle), #514 can be closed to avoid the maintenance burden of two parallel PRs touching the same files.

NFTDreww added a commit to NFTDreww/frameworks that referenced this pull request Jul 7, 2026
Adjusted to fixes called out in security-alliance#513  to flesh with security-alliance#514
@NFTDreww NFTDreww mentioned this pull request Jul 7, 2026
9 tasks
NFTDreww added a commit to NFTDreww/frameworks that referenced this pull request Jul 7, 2026
Updating fixed to this to address call outs from security-alliance#513 & security-alliance#514
@NFTDreww NFTDreww mentioned this pull request Jul 7, 2026
9 tasks
NFTDreww added a commit to NFTDreww/frameworks that referenced this pull request Jul 7, 2026
Updating Twitter to address call outs in security-alliance#513 and security-alliance#514
@NFTDreww NFTDreww mentioned this pull request Jul 7, 2026
9 tasks
@NFTDreww

NFTDreww commented Jul 7, 2026

Copy link
Copy Markdown
Collaborator Author

Fixed Discord #513 with #547.

Fixed twitter in patch #548

@scode2277 scode2277 closed this Jul 7, 2026
mattaereal pushed a commit that referenced this pull request Jul 8, 2026
* Update overview.mdx

I have updated the overall update overview to be more inline with the feedback given over the past few weeks, which were:

1) Reframe the intro as a wayfinding statement. Instead of opening with a content summary, open with a one- or two-sentence orientation about what community security covers and where to go. Something like: "Community Management security spans several disciplines — each with its own dedicated Framework. Use this page to find the right one."

2) Convert the best practices section into a visual index. Each of the four sections (2FA/passwords, phishing, OpSec, emergency response) already has a corresponding Framework, so we can turn them into explicit cards or a linked table with the topic, a single descriptive sentence, and the link. This keeps the content without making it feel like a dead end.

3) Cut the inline detail that lives somewhere else. For example, TOTP configuration advice, the password manager separation rule, and the DM-first policy all belong in the destination frameworks, not here. Keeping it here creates both a maintenance burden for your team and dilutes the "go there for more" message.

------------------------------------------------------------------------
Therefore I was able to make the community manage guides more of the why, what, and how/where? Explaining this information and then leading into the actual frameworks for each that ALL needs to be taken into consideration when talking about community management and it's subsequent guides/frameworks.

This included a complete reformat of this page, that I think addresses all feedback and has a cleaner flow to providing the north star for this section.

* Update discord.mdx

I have updated the overall update overview to be more inline with the feedback given over the past few weeks, which were:

Reframe the intro as a wayfinding statement. Instead of opening with a content summary, open with a one- or two-sentence orientation about what community security covers and where to go. Something like: "Community Management security spans several disciplines — each with its own dedicated Framework. Use this page to find the right one."

Convert the best practices section into a visual index. Each of the four sections (2FA/passwords, phishing, OpSec, emergency response) already has a corresponding Framework, so we can turn them into explicit cards or a linked table with the topic, a single descriptive sentence, and the link. This keeps the content without making it feel like a dead end.

Cut the inline detail that lives somewhere else. For example, TOTP configuration advice, the password manager separation rule, and the DM-first policy all belong in the destination frameworks, not here. Keeping it here creates both a maintenance burden for your team and dilutes the "go there for more" message.

------------------------------------------------------------------------ Therefore I was able to make the community manage guides more of the why, what, and how/where? Explaining this information and then leading into the actual frameworks for each that ALL needs to be taken into consideration when talking about community management and it's subsequent guides/frameworks.

This included a complete reformat of this page, that I think addresses all feedback and has a cleaner flow to providing the north star for this section.

* Update telegram.mdx

I have updated the overall update overview to be more inline with the feedback given over the past few weeks, which were:

Reframe the intro as a wayfinding statement. Instead of opening with a content summary, open with a one- or two-sentence orientation about what community security covers and where to go. Something like: "Community Management security spans several disciplines — each with its own dedicated Framework. Use this page to find the right one."

Convert the best practices section into a visual index. Each of the four sections (2FA/passwords, phishing, OpSec, emergency response) already has a corresponding Framework, so we can turn them into explicit cards or a linked table with the topic, a single descriptive sentence, and the link. This keeps the content without making it feel like a dead end.

Cut the inline detail that lives somewhere else. For example, TOTP configuration advice, the password manager separation rule, and the DM-first policy all belong in the destination frameworks, not here. Keeping it here creates both a maintenance burden for your team and dilutes the "go there for more" message.

------------------------------------------------------------------------ Therefore I was able to make the community manage guides more of the why, what, and how/where? Explaining this information and then leading into the actual frameworks for each that ALL needs to be taken into consideration when talking about community management and it's subsequent guides/frameworks.

This included a complete reformat of this page, that I think addresses all feedback and has a cleaner flow to providing the north star for this section.

* Update slug to make attribution list visible

* Update slug to make contributor profile visible

* Remove manually added contribute call

* Update docs/pages/community-management/overview.mdx

* Update docs/pages/community-management/telegram.mdx

* Update docs/pages/community-management/discord.mdx

* Update docs/pages/community-management/discord.mdx

* Update docs/pages/community-management/overview.mdx

* Update docs/pages/community-management/telegram.mdx

* Update docs/pages/community-management/telegram.mdx

* Update docs/pages/community-management/telegram.mdx

* Remove components

* Update links to make them relative in the discord file

* Update links to make them relative in the overview file

* Update links to make them relative in the telegram file

* Remove call to contribution line from discord file

* Update twitter.mdx

Updating fixed to this to address call outs from #513 & #514

* Remove manually added contribution call

---------

Co-authored-by: Sara Russo <sararusso984@gmail.com>
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

Successfully merging this pull request may close these issues.

3 participants