Skip to content

[WIP] Create target-audience.md - #233

Closed
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience
Closed

[WIP] Create target-audience.md#233
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience

Conversation

@pavlenex

Copy link
Copy Markdown
Contributor

This is literally copy-pasted version of this Google Document.
The goal of this PR is to kick things off, lay out the structure and engage contributors into filling the gaps.

Feel free to suggest edits, comment on the structure, etc. This is a very very rough draft.

Once fully polished:
Closes#51

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Thanks @pavlenex for breathing life back into this one. This originally came up, IIRC, from a question by @ConorOkus. I believe it's also relevant to the discussions here, about the backup page speaking to the end-user vs a product builder.

@GBKSGBKS added Copy Task is about improving text. Help wanted Extra attention is needed labels Apr 15, 2021
@danielnordh

danielnordh commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?
I can't find a link to the page.

I think the content of that doc is directionally correct (we are not making the guide for end users, and there are a few personas in that group). It is not written for general consumption however, so a copy and paste might need a fair amount of cleanup.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.
So it remains a question where that content should go.

  • Sub-resources: bitcoin.design/resources/backups etc.
  • Sub-domains: backups.bitcoin.design
  • Separate microsites: bitcoinbackups.org, selfcustody.org, bitcoinforbeginners.org ...

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

@danielnordh try this link here.

Looks like links on PR preview pages are now messed up and always link to bitcoin.design instead of keeping you on that preview domain. A side effect of fixing the canonical URLs. Will have to review this.

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

If we don't want to have a full page on this topic, we can just expand the Know your reader paragraph in the content guidelines page a bit further.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?

@danielnordh Yes, I haven't done any navigation additions yet it seems.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.

I agree, I assume that's what we meant with Bitcoiners1 persona?

@danielnordh if you have any concrete ideas, feel free to take over or suggest them, I just copy-pasted the work from Google Doc so we can keep the ball rolling, it needs a bit more work that's for sure.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Considering condensing this for now to a simple paragraph in the https://bitcoin.design/guide/contribute/content-guidelines/#speak-to-the-reader since there's no major consensus to proceed with this in-depth for now. It's getting clearer at this point that we write for designers, developers, and sometimes even users who can benefit from itit.

GBKS added a commit that referenced this pull request Apr 27, 2021
This is an alternative suggestion to PR #233, specifically the discussion here: #233 (comment)
@GBKS

GBKS commented Apr 27, 2021

Copy link
Copy Markdown
Contributor

@pavlenex I created a PR with that minor update to the "Know your reader" paragraph in the "Content guidelines" page. See #263.

Let's get some comments on whether that minor update is enough or we need this bigger page. I'm voting for the minor update.

This audience definition is just for the guide (IMHO). If we do workshops or other projects, they can have other audiences, whether that's a subset or a different group of people. So I'd keep this one fairly simple.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.Help wantedExtra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define audience for the guide

3 participants

@pavlenex@GBKS@danielnordh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
[WIP] Create target-audience.md by pavlenex · Pull Request #233 · BitcoinDesign/Guide · GitHub
Skip to content

[WIP] Create target-audience.md - #233

Closed
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience
Closed

[WIP] Create target-audience.md#233
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience

Conversation

@pavlenex

Copy link
Copy Markdown
Contributor

This is literally copy-pasted version of this Google Document.
The goal of this PR is to kick things off, lay out the structure and engage contributors into filling the gaps.

Feel free to suggest edits, comment on the structure, etc. This is a very very rough draft.

Once fully polished:
Closes#51

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Thanks @pavlenex for breathing life back into this one. This originally came up, IIRC, from a question by @ConorOkus. I believe it's also relevant to the discussions here, about the backup page speaking to the end-user vs a product builder.

@GBKSGBKS added Copy Task is about improving text. Help wanted Extra attention is needed labels Apr 15, 2021
@danielnordh

danielnordh commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?
I can't find a link to the page.

I think the content of that doc is directionally correct (we are not making the guide for end users, and there are a few personas in that group). It is not written for general consumption however, so a copy and paste might need a fair amount of cleanup.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.
So it remains a question where that content should go.

  • Sub-resources: bitcoin.design/resources/backups etc.
  • Sub-domains: backups.bitcoin.design
  • Separate microsites: bitcoinbackups.org, selfcustody.org, bitcoinforbeginners.org ...

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

@danielnordh try this link here.

Looks like links on PR preview pages are now messed up and always link to bitcoin.design instead of keeping you on that preview domain. A side effect of fixing the canonical URLs. Will have to review this.

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

If we don't want to have a full page on this topic, we can just expand the Know your reader paragraph in the content guidelines page a bit further.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?

@danielnordh Yes, I haven't done any navigation additions yet it seems.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.

I agree, I assume that's what we meant with Bitcoiners1 persona?

@danielnordh if you have any concrete ideas, feel free to take over or suggest them, I just copy-pasted the work from Google Doc so we can keep the ball rolling, it needs a bit more work that's for sure.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Considering condensing this for now to a simple paragraph in the https://bitcoin.design/guide/contribute/content-guidelines/#speak-to-the-reader since there's no major consensus to proceed with this in-depth for now. It's getting clearer at this point that we write for designers, developers, and sometimes even users who can benefit from itit.

GBKS added a commit that referenced this pull request Apr 27, 2021
This is an alternative suggestion to PR #233, specifically the discussion here: #233 (comment)
@GBKS

GBKS commented Apr 27, 2021

Copy link
Copy Markdown
Contributor

@pavlenex I created a PR with that minor update to the "Know your reader" paragraph in the "Content guidelines" page. See #263.

Let's get some comments on whether that minor update is enough or we need this bigger page. I'm voting for the minor update.

This audience definition is just for the guide (IMHO). If we do workshops or other projects, they can have other audiences, whether that's a subset or a different group of people. So I'd keep this one fairly simple.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.Help wantedExtra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define audience for the guide

3 participants

@pavlenex@GBKS@danielnordh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [WIP] Create target-audience.md by pavlenex · Pull Request #233 · BitcoinDesign/Guide · GitHub
Skip to content

[WIP] Create target-audience.md - #233

Closed
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience
Closed

[WIP] Create target-audience.md#233
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience

Conversation

@pavlenex

Copy link
Copy Markdown
Contributor

This is literally copy-pasted version of this Google Document.
The goal of this PR is to kick things off, lay out the structure and engage contributors into filling the gaps.

Feel free to suggest edits, comment on the structure, etc. This is a very very rough draft.

Once fully polished:
Closes#51

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Thanks @pavlenex for breathing life back into this one. This originally came up, IIRC, from a question by @ConorOkus. I believe it's also relevant to the discussions here, about the backup page speaking to the end-user vs a product builder.

@GBKSGBKS added Copy Task is about improving text. Help wanted Extra attention is needed labels Apr 15, 2021
@danielnordh

danielnordh commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?
I can't find a link to the page.

I think the content of that doc is directionally correct (we are not making the guide for end users, and there are a few personas in that group). It is not written for general consumption however, so a copy and paste might need a fair amount of cleanup.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.
So it remains a question where that content should go.

  • Sub-resources: bitcoin.design/resources/backups etc.
  • Sub-domains: backups.bitcoin.design
  • Separate microsites: bitcoinbackups.org, selfcustody.org, bitcoinforbeginners.org ...

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

@danielnordh try this link here.

Looks like links on PR preview pages are now messed up and always link to bitcoin.design instead of keeping you on that preview domain. A side effect of fixing the canonical URLs. Will have to review this.

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

If we don't want to have a full page on this topic, we can just expand the Know your reader paragraph in the content guidelines page a bit further.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?

@danielnordh Yes, I haven't done any navigation additions yet it seems.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.

I agree, I assume that's what we meant with Bitcoiners1 persona?

@danielnordh if you have any concrete ideas, feel free to take over or suggest them, I just copy-pasted the work from Google Doc so we can keep the ball rolling, it needs a bit more work that's for sure.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Considering condensing this for now to a simple paragraph in the https://bitcoin.design/guide/contribute/content-guidelines/#speak-to-the-reader since there's no major consensus to proceed with this in-depth for now. It's getting clearer at this point that we write for designers, developers, and sometimes even users who can benefit from itit.

GBKS added a commit that referenced this pull request Apr 27, 2021
This is an alternative suggestion to PR #233, specifically the discussion here: #233 (comment)
@GBKS

GBKS commented Apr 27, 2021

Copy link
Copy Markdown
Contributor

@pavlenex I created a PR with that minor update to the "Know your reader" paragraph in the "Content guidelines" page. See #263.

Let's get some comments on whether that minor update is enough or we need this bigger page. I'm voting for the minor update.

This audience definition is just for the guide (IMHO). If we do workshops or other projects, they can have other audiences, whether that's a subset or a different group of people. So I'd keep this one fairly simple.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.Help wantedExtra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define audience for the guide

3 participants

@pavlenex@GBKS@danielnordh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [WIP] Create target-audience.md by pavlenex · Pull Request #233 · BitcoinDesign/Guide · GitHub
Skip to content

[WIP] Create target-audience.md - #233

Closed
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience
Closed

[WIP] Create target-audience.md#233
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience

Conversation

@pavlenex

Copy link
Copy Markdown
Contributor

This is literally copy-pasted version of this Google Document.
The goal of this PR is to kick things off, lay out the structure and engage contributors into filling the gaps.

Feel free to suggest edits, comment on the structure, etc. This is a very very rough draft.

Once fully polished:
Closes#51

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Thanks @pavlenex for breathing life back into this one. This originally came up, IIRC, from a question by @ConorOkus. I believe it's also relevant to the discussions here, about the backup page speaking to the end-user vs a product builder.

@GBKSGBKS added Copy Task is about improving text. Help wanted Extra attention is needed labels Apr 15, 2021
@danielnordh

danielnordh commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?
I can't find a link to the page.

I think the content of that doc is directionally correct (we are not making the guide for end users, and there are a few personas in that group). It is not written for general consumption however, so a copy and paste might need a fair amount of cleanup.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.
So it remains a question where that content should go.

  • Sub-resources: bitcoin.design/resources/backups etc.
  • Sub-domains: backups.bitcoin.design
  • Separate microsites: bitcoinbackups.org, selfcustody.org, bitcoinforbeginners.org ...

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

@danielnordh try this link here.

Looks like links on PR preview pages are now messed up and always link to bitcoin.design instead of keeping you on that preview domain. A side effect of fixing the canonical URLs. Will have to review this.

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

If we don't want to have a full page on this topic, we can just expand the Know your reader paragraph in the content guidelines page a bit further.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?

@danielnordh Yes, I haven't done any navigation additions yet it seems.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.

I agree, I assume that's what we meant with Bitcoiners1 persona?

@danielnordh if you have any concrete ideas, feel free to take over or suggest them, I just copy-pasted the work from Google Doc so we can keep the ball rolling, it needs a bit more work that's for sure.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Considering condensing this for now to a simple paragraph in the https://bitcoin.design/guide/contribute/content-guidelines/#speak-to-the-reader since there's no major consensus to proceed with this in-depth for now. It's getting clearer at this point that we write for designers, developers, and sometimes even users who can benefit from itit.

GBKS added a commit that referenced this pull request Apr 27, 2021
This is an alternative suggestion to PR #233, specifically the discussion here: #233 (comment)
@GBKS

GBKS commented Apr 27, 2021

Copy link
Copy Markdown
Contributor

@pavlenex I created a PR with that minor update to the "Know your reader" paragraph in the "Content guidelines" page. See #263.

Let's get some comments on whether that minor update is enough or we need this bigger page. I'm voting for the minor update.

This audience definition is just for the guide (IMHO). If we do workshops or other projects, they can have other audiences, whether that's a subset or a different group of people. So I'd keep this one fairly simple.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.Help wantedExtra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define audience for the guide

3 participants

@pavlenex@GBKS@danielnordh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' [WIP] Create target-audience.md by pavlenex · Pull Request #233 · BitcoinDesign/Guide · GitHub
Skip to content

[WIP] Create target-audience.md - #233

Closed
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience
Closed

[WIP] Create target-audience.md#233
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience

Conversation

@pavlenex

Copy link
Copy Markdown
Contributor

This is literally copy-pasted version of this Google Document.
The goal of this PR is to kick things off, lay out the structure and engage contributors into filling the gaps.

Feel free to suggest edits, comment on the structure, etc. This is a very very rough draft.

Once fully polished:
Closes#51

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Thanks @pavlenex for breathing life back into this one. This originally came up, IIRC, from a question by @ConorOkus. I believe it's also relevant to the discussions here, about the backup page speaking to the end-user vs a product builder.

@GBKSGBKS added Copy Task is about improving text. Help wanted Extra attention is needed labels Apr 15, 2021
@danielnordh

danielnordh commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?
I can't find a link to the page.

I think the content of that doc is directionally correct (we are not making the guide for end users, and there are a few personas in that group). It is not written for general consumption however, so a copy and paste might need a fair amount of cleanup.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.
So it remains a question where that content should go.

  • Sub-resources: bitcoin.design/resources/backups etc.
  • Sub-domains: backups.bitcoin.design
  • Separate microsites: bitcoinbackups.org, selfcustody.org, bitcoinforbeginners.org ...

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

@danielnordh try this link here.

Looks like links on PR preview pages are now messed up and always link to bitcoin.design instead of keeping you on that preview domain. A side effect of fixing the canonical URLs. Will have to review this.

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

If we don't want to have a full page on this topic, we can just expand the Know your reader paragraph in the content guidelines page a bit further.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?

@danielnordh Yes, I haven't done any navigation additions yet it seems.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.

I agree, I assume that's what we meant with Bitcoiners1 persona?

@danielnordh if you have any concrete ideas, feel free to take over or suggest them, I just copy-pasted the work from Google Doc so we can keep the ball rolling, it needs a bit more work that's for sure.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Considering condensing this for now to a simple paragraph in the https://bitcoin.design/guide/contribute/content-guidelines/#speak-to-the-reader since there's no major consensus to proceed with this in-depth for now. It's getting clearer at this point that we write for designers, developers, and sometimes even users who can benefit from itit.

GBKS added a commit that referenced this pull request Apr 27, 2021
This is an alternative suggestion to PR #233, specifically the discussion here: #233 (comment)
@GBKS

GBKS commented Apr 27, 2021

Copy link
Copy Markdown
Contributor

@pavlenex I created a PR with that minor update to the "Know your reader" paragraph in the "Content guidelines" page. See #263.

Let's get some comments on whether that minor update is enough or we need this bigger page. I'm voting for the minor update.

This audience definition is just for the guide (IMHO). If we do workshops or other projects, they can have other audiences, whether that's a subset or a different group of people. So I'd keep this one fairly simple.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.Help wantedExtra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define audience for the guide

3 participants

@pavlenex@GBKS@danielnordh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [WIP] Create target-audience.md by pavlenex · Pull Request #233 · BitcoinDesign/Guide · GitHub
Skip to content

[WIP] Create target-audience.md - #233

Closed
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience
Closed

[WIP] Create target-audience.md#233
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience

Conversation

@pavlenex

Copy link
Copy Markdown
Contributor

This is literally copy-pasted version of this Google Document.
The goal of this PR is to kick things off, lay out the structure and engage contributors into filling the gaps.

Feel free to suggest edits, comment on the structure, etc. This is a very very rough draft.

Once fully polished:
Closes#51

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Thanks @pavlenex for breathing life back into this one. This originally came up, IIRC, from a question by @ConorOkus. I believe it's also relevant to the discussions here, about the backup page speaking to the end-user vs a product builder.

@GBKSGBKS added Copy Task is about improving text. Help wanted Extra attention is needed labels Apr 15, 2021
@danielnordh

danielnordh commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?
I can't find a link to the page.

I think the content of that doc is directionally correct (we are not making the guide for end users, and there are a few personas in that group). It is not written for general consumption however, so a copy and paste might need a fair amount of cleanup.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.
So it remains a question where that content should go.

  • Sub-resources: bitcoin.design/resources/backups etc.
  • Sub-domains: backups.bitcoin.design
  • Separate microsites: bitcoinbackups.org, selfcustody.org, bitcoinforbeginners.org ...

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

@danielnordh try this link here.

Looks like links on PR preview pages are now messed up and always link to bitcoin.design instead of keeping you on that preview domain. A side effect of fixing the canonical URLs. Will have to review this.

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

If we don't want to have a full page on this topic, we can just expand the Know your reader paragraph in the content guidelines page a bit further.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?

@danielnordh Yes, I haven't done any navigation additions yet it seems.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.

I agree, I assume that's what we meant with Bitcoiners1 persona?

@danielnordh if you have any concrete ideas, feel free to take over or suggest them, I just copy-pasted the work from Google Doc so we can keep the ball rolling, it needs a bit more work that's for sure.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Considering condensing this for now to a simple paragraph in the https://bitcoin.design/guide/contribute/content-guidelines/#speak-to-the-reader since there's no major consensus to proceed with this in-depth for now. It's getting clearer at this point that we write for designers, developers, and sometimes even users who can benefit from itit.

GBKS added a commit that referenced this pull request Apr 27, 2021
This is an alternative suggestion to PR #233, specifically the discussion here: #233 (comment)
@GBKS

GBKS commented Apr 27, 2021

Copy link
Copy Markdown
Contributor

@pavlenex I created a PR with that minor update to the "Know your reader" paragraph in the "Content guidelines" page. See #263.

Let's get some comments on whether that minor update is enough or we need this bigger page. I'm voting for the minor update.

This audience definition is just for the guide (IMHO). If we do workshops or other projects, they can have other audiences, whether that's a subset or a different group of people. So I'd keep this one fairly simple.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.Help wantedExtra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define audience for the guide

3 participants

@pavlenex@GBKS@danielnordh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' [WIP] Create target-audience.md by pavlenex · Pull Request #233 · BitcoinDesign/Guide · GitHub
Skip to content

[WIP] Create target-audience.md - #233

Closed
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience
Closed

[WIP] Create target-audience.md#233
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience

Conversation

@pavlenex

Copy link
Copy Markdown
Contributor

This is literally copy-pasted version of this Google Document.
The goal of this PR is to kick things off, lay out the structure and engage contributors into filling the gaps.

Feel free to suggest edits, comment on the structure, etc. This is a very very rough draft.

Once fully polished:
Closes#51

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Thanks @pavlenex for breathing life back into this one. This originally came up, IIRC, from a question by @ConorOkus. I believe it's also relevant to the discussions here, about the backup page speaking to the end-user vs a product builder.

@GBKSGBKS added Copy Task is about improving text. Help wanted Extra attention is needed labels Apr 15, 2021
@danielnordh

danielnordh commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?
I can't find a link to the page.

I think the content of that doc is directionally correct (we are not making the guide for end users, and there are a few personas in that group). It is not written for general consumption however, so a copy and paste might need a fair amount of cleanup.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.
So it remains a question where that content should go.

  • Sub-resources: bitcoin.design/resources/backups etc.
  • Sub-domains: backups.bitcoin.design
  • Separate microsites: bitcoinbackups.org, selfcustody.org, bitcoinforbeginners.org ...

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

@danielnordh try this link here.

Looks like links on PR preview pages are now messed up and always link to bitcoin.design instead of keeping you on that preview domain. A side effect of fixing the canonical URLs. Will have to review this.

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

If we don't want to have a full page on this topic, we can just expand the Know your reader paragraph in the content guidelines page a bit further.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?

@danielnordh Yes, I haven't done any navigation additions yet it seems.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.

I agree, I assume that's what we meant with Bitcoiners1 persona?

@danielnordh if you have any concrete ideas, feel free to take over or suggest them, I just copy-pasted the work from Google Doc so we can keep the ball rolling, it needs a bit more work that's for sure.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Considering condensing this for now to a simple paragraph in the https://bitcoin.design/guide/contribute/content-guidelines/#speak-to-the-reader since there's no major consensus to proceed with this in-depth for now. It's getting clearer at this point that we write for designers, developers, and sometimes even users who can benefit from itit.

GBKS added a commit that referenced this pull request Apr 27, 2021
This is an alternative suggestion to PR #233, specifically the discussion here: #233 (comment)
@GBKS

GBKS commented Apr 27, 2021

Copy link
Copy Markdown
Contributor

@pavlenex I created a PR with that minor update to the "Know your reader" paragraph in the "Content guidelines" page. See #263.

Let's get some comments on whether that minor update is enough or we need this bigger page. I'm voting for the minor update.

This audience definition is just for the guide (IMHO). If we do workshops or other projects, they can have other audiences, whether that's a subset or a different group of people. So I'd keep this one fairly simple.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.Help wantedExtra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define audience for the guide

3 participants

@pavlenex@GBKS@danielnordh
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); [WIP] Create target-audience.md by pavlenex · Pull Request #233 · BitcoinDesign/Guide · GitHub
Skip to content

[WIP] Create target-audience.md - #233

Closed
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience
Closed

[WIP] Create target-audience.md#233
pavlenex wants to merge 1 commit into
BitcoinDesign:masterfrom
pavlenex:target-audience

Conversation

@pavlenex

Copy link
Copy Markdown
Contributor

This is literally copy-pasted version of this Google Document.
The goal of this PR is to kick things off, lay out the structure and engage contributors into filling the gaps.

Feel free to suggest edits, comment on the structure, etc. This is a very very rough draft.

Once fully polished:
Closes#51

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Thanks @pavlenex for breathing life back into this one. This originally came up, IIRC, from a question by @ConorOkus. I believe it's also relevant to the discussions here, about the backup page speaking to the end-user vs a product builder.

@GBKSGBKS added Copy Task is about improving text. Help wanted Extra attention is needed labels Apr 15, 2021
@danielnordh

danielnordh commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?
I can't find a link to the page.

I think the content of that doc is directionally correct (we are not making the guide for end users, and there are a few personas in that group). It is not written for general consumption however, so a copy and paste might need a fair amount of cleanup.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.
So it remains a question where that content should go.

  • Sub-resources: bitcoin.design/resources/backups etc.
  • Sub-domains: backups.bitcoin.design
  • Separate microsites: bitcoinbackups.org, selfcustody.org, bitcoinforbeginners.org ...

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

@danielnordh try this link here.

Looks like links on PR preview pages are now messed up and always link to bitcoin.design instead of keeping you on that preview domain. A side effect of fixing the canonical URLs. Will have to review this.

@GBKS

GBKS commented Apr 16, 2021

Copy link
Copy Markdown
Contributor

If we don't want to have a full page on this topic, we can just expand the Know your reader paragraph in the content guidelines page a bit further.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Is it supposed to be linked to from the 'Contribute' section, and be listed in the side nav?

@danielnordh Yes, I haven't done any navigation additions yet it seems.

I also feel however, that as a community we are likely to create content that is relevant, and needed, for end users.

I agree, I assume that's what we meant with Bitcoiners1 persona?

@danielnordh if you have any concrete ideas, feel free to take over or suggest them, I just copy-pasted the work from Google Doc so we can keep the ball rolling, it needs a bit more work that's for sure.

@pavlenex

Copy link
Copy Markdown
ContributorAuthor

Considering condensing this for now to a simple paragraph in the https://bitcoin.design/guide/contribute/content-guidelines/#speak-to-the-reader since there's no major consensus to proceed with this in-depth for now. It's getting clearer at this point that we write for designers, developers, and sometimes even users who can benefit from itit.

GBKS added a commit that referenced this pull request Apr 27, 2021
This is an alternative suggestion to PR #233, specifically the discussion here: #233 (comment)
@GBKS

GBKS commented Apr 27, 2021

Copy link
Copy Markdown
Contributor

@pavlenex I created a PR with that minor update to the "Know your reader" paragraph in the "Content guidelines" page. See #263.

Let's get some comments on whether that minor update is enough or we need this bigger page. I'm voting for the minor update.

This audience definition is just for the guide (IMHO). If we do workshops or other projects, they can have other audiences, whether that's a subset or a different group of people. So I'd keep this one fairly simple.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.Help wantedExtra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define audience for the guide

3 participants

@pavlenex@GBKS@danielnordh