Skip to content

Bitcoin backups page in Private key management - #210

Closed
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups
Closed

Bitcoin backups page in Private key management#210
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups

Conversation

@danielnordh

@danielnordhdanielnordh commented Apr 2, 2021

Copy link
Copy Markdown
Contributor

PR for issue #139

Adds a page under Private Key Management with a guide to Bitcoin backups.

@GBKSGBKS added the Copy Task is about improving text. label Apr 7, 2021

@pavlenexpavlenex left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@danielnordh

danielnordh commented Apr 9, 2021

Copy link
Copy Markdown
ContributorAuthor

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Agree that this speaks to a different audience, but it was deliberate.
The intention here was to have a guide for end-users that can be a reference.

We could either:

  • Rewrite for the designer/developer audience, who would then have to write the version for the end-user
  • Figure out where 'end-user' facing material could/should live on the site (if at all)

Personally I feel that this kind of guide is absolutely essential to get more people to self-custody.

I'll ignore your detailed comments for now until the audience for this page, and it's place on the site has been agreed.

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh I didn't know it's deliberate, do we expect end-users to visit the design guide and get an education, or should we leave that to other projects? I'm just curious, it's a good document, I just don't feel it's fitting well with the rest of the content that addresses the app creates instead of the end users.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

To weigh in on whether this fits into the guide, I think the content is interesting to both end-users and product-builders. Even us relatively experienced Bitcoiners are struggling with this issue. The fact that several sites exist (Glacier, Yeti, 10x) that also try to tackle this reinforces that this is a need.

I suggest turning this into a mini-project with its own microsite, possible combined with the backup builder concept (add an inheritance sheet also). End-users can use this to help them sort out their backup needs. Designers can learn by studying the different solutions. Product builders can link to this instead of having to create their own guide.

A dedicated microsite would allow for crowd-sourced contributions and localization, making it more widely useful.

We could also turn this into a larger effort that we could call the "Bitcoin User Guide". It could cover more tips (like avoiding address reuse) that are independent of which software or hardware is being used. It would fit with our larger goal of making Bitcoin easier to use.

@pavlenex

Copy link
Copy Markdown
Contributor

@GBKS That's a good idea, but we should talk and consider if too much watering down the Design Guide with too many side-projects is beneficial. At the end of the day, we do want our target audience to be able to find stuff easily, if we keep "side-project" everything, it may influence the ease of navigation and the quality of content in the guide.

This is more general thought though, not specifically 1:1 related to this PR. ^

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Might be a good topic for the "Discussion" page.

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Capturing thoughts from the sprint planning call:

  • Finish up the page, OK to write for end users (preface at the beginning)
  • The content can be taken and re-used in a more accessible form for end-user impact (microsites, existing user-facing sites etc.)
  • Consider whether page makes more sense in Foundations or PKM

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh Do you need any help with this, what's left in your opinion so we can get this one ready for review?

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

I'm planning to wrap this up this week, should be ready by Friday.

@GBKSGBKS linked an issue May 6, 2021 that may be closed by this pull request
@GBKSGBKS added this to the Sprint #4 milestone May 6, 2021
@danielnordhdanielnordh changed the title WIP - Bitcoin backups page in FoundationBitcoin backups page in FoundationMay 7, 2021
@danielnordhdanielnordh changed the title Bitcoin backups page in FoundationBitcoin backups page in Private key managementMay 7, 2021
@danielnordh
danielnordh marked this pull request as ready for review May 10, 2021 10:17
@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Due to messed up merge history with this commit I've moved the work over to a fresh PR:
#305

danielnordh added a commit that referenced this pull request May 11, 2021
@danielnordh
danielnordh deleted the bitcoinbackups branch May 11, 2021 12:29
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create page - Recovery backup storage 101

6 participants

@danielnordh@pavlenex@GBKS@johnsBeharry@sbddesign@joseabarreram
, '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" + '
Bitcoin backups page in Private key management by danielnordh · Pull Request #210 · BitcoinDesign/Guide · GitHub
Skip to content

Bitcoin backups page in Private key management - #210

Closed
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups
Closed

Bitcoin backups page in Private key management#210
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups

Conversation

@danielnordh

@danielnordhdanielnordh commented Apr 2, 2021

Copy link
Copy Markdown
Contributor

PR for issue #139

Adds a page under Private Key Management with a guide to Bitcoin backups.

@GBKSGBKS added the Copy Task is about improving text. label Apr 7, 2021

@pavlenexpavlenex left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@danielnordh

danielnordh commented Apr 9, 2021

Copy link
Copy Markdown
ContributorAuthor

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Agree that this speaks to a different audience, but it was deliberate.
The intention here was to have a guide for end-users that can be a reference.

We could either:

  • Rewrite for the designer/developer audience, who would then have to write the version for the end-user
  • Figure out where 'end-user' facing material could/should live on the site (if at all)

Personally I feel that this kind of guide is absolutely essential to get more people to self-custody.

I'll ignore your detailed comments for now until the audience for this page, and it's place on the site has been agreed.

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh I didn't know it's deliberate, do we expect end-users to visit the design guide and get an education, or should we leave that to other projects? I'm just curious, it's a good document, I just don't feel it's fitting well with the rest of the content that addresses the app creates instead of the end users.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

To weigh in on whether this fits into the guide, I think the content is interesting to both end-users and product-builders. Even us relatively experienced Bitcoiners are struggling with this issue. The fact that several sites exist (Glacier, Yeti, 10x) that also try to tackle this reinforces that this is a need.

I suggest turning this into a mini-project with its own microsite, possible combined with the backup builder concept (add an inheritance sheet also). End-users can use this to help them sort out their backup needs. Designers can learn by studying the different solutions. Product builders can link to this instead of having to create their own guide.

A dedicated microsite would allow for crowd-sourced contributions and localization, making it more widely useful.

We could also turn this into a larger effort that we could call the "Bitcoin User Guide". It could cover more tips (like avoiding address reuse) that are independent of which software or hardware is being used. It would fit with our larger goal of making Bitcoin easier to use.

@pavlenex

Copy link
Copy Markdown
Contributor

@GBKS That's a good idea, but we should talk and consider if too much watering down the Design Guide with too many side-projects is beneficial. At the end of the day, we do want our target audience to be able to find stuff easily, if we keep "side-project" everything, it may influence the ease of navigation and the quality of content in the guide.

This is more general thought though, not specifically 1:1 related to this PR. ^

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Might be a good topic for the "Discussion" page.

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Capturing thoughts from the sprint planning call:

  • Finish up the page, OK to write for end users (preface at the beginning)
  • The content can be taken and re-used in a more accessible form for end-user impact (microsites, existing user-facing sites etc.)
  • Consider whether page makes more sense in Foundations or PKM

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh Do you need any help with this, what's left in your opinion so we can get this one ready for review?

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

I'm planning to wrap this up this week, should be ready by Friday.

@GBKSGBKS linked an issue May 6, 2021 that may be closed by this pull request
@GBKSGBKS added this to the Sprint #4 milestone May 6, 2021
@danielnordhdanielnordh changed the title WIP - Bitcoin backups page in FoundationBitcoin backups page in FoundationMay 7, 2021
@danielnordhdanielnordh changed the title Bitcoin backups page in FoundationBitcoin backups page in Private key managementMay 7, 2021
@danielnordh
danielnordh marked this pull request as ready for review May 10, 2021 10:17
@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Due to messed up merge history with this commit I've moved the work over to a fresh PR:
#305

danielnordh added a commit that referenced this pull request May 11, 2021
@danielnordh
danielnordh deleted the bitcoinbackups branch May 11, 2021 12:29
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create page - Recovery backup storage 101

6 participants

@danielnordh@pavlenex@GBKS@johnsBeharry@sbddesign@joseabarreram
, '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('^' + ".*" + ' Bitcoin backups page in Private key management by danielnordh · Pull Request #210 · BitcoinDesign/Guide · GitHub
Skip to content

Bitcoin backups page in Private key management - #210

Closed
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups
Closed

Bitcoin backups page in Private key management#210
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups

Conversation

@danielnordh

@danielnordhdanielnordh commented Apr 2, 2021

Copy link
Copy Markdown
Contributor

PR for issue #139

Adds a page under Private Key Management with a guide to Bitcoin backups.

@GBKSGBKS added the Copy Task is about improving text. label Apr 7, 2021

@pavlenexpavlenex left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@danielnordh

danielnordh commented Apr 9, 2021

Copy link
Copy Markdown
ContributorAuthor

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Agree that this speaks to a different audience, but it was deliberate.
The intention here was to have a guide for end-users that can be a reference.

We could either:

  • Rewrite for the designer/developer audience, who would then have to write the version for the end-user
  • Figure out where 'end-user' facing material could/should live on the site (if at all)

Personally I feel that this kind of guide is absolutely essential to get more people to self-custody.

I'll ignore your detailed comments for now until the audience for this page, and it's place on the site has been agreed.

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh I didn't know it's deliberate, do we expect end-users to visit the design guide and get an education, or should we leave that to other projects? I'm just curious, it's a good document, I just don't feel it's fitting well with the rest of the content that addresses the app creates instead of the end users.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

To weigh in on whether this fits into the guide, I think the content is interesting to both end-users and product-builders. Even us relatively experienced Bitcoiners are struggling with this issue. The fact that several sites exist (Glacier, Yeti, 10x) that also try to tackle this reinforces that this is a need.

I suggest turning this into a mini-project with its own microsite, possible combined with the backup builder concept (add an inheritance sheet also). End-users can use this to help them sort out their backup needs. Designers can learn by studying the different solutions. Product builders can link to this instead of having to create their own guide.

A dedicated microsite would allow for crowd-sourced contributions and localization, making it more widely useful.

We could also turn this into a larger effort that we could call the "Bitcoin User Guide". It could cover more tips (like avoiding address reuse) that are independent of which software or hardware is being used. It would fit with our larger goal of making Bitcoin easier to use.

@pavlenex

Copy link
Copy Markdown
Contributor

@GBKS That's a good idea, but we should talk and consider if too much watering down the Design Guide with too many side-projects is beneficial. At the end of the day, we do want our target audience to be able to find stuff easily, if we keep "side-project" everything, it may influence the ease of navigation and the quality of content in the guide.

This is more general thought though, not specifically 1:1 related to this PR. ^

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Might be a good topic for the "Discussion" page.

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Capturing thoughts from the sprint planning call:

  • Finish up the page, OK to write for end users (preface at the beginning)
  • The content can be taken and re-used in a more accessible form for end-user impact (microsites, existing user-facing sites etc.)
  • Consider whether page makes more sense in Foundations or PKM

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh Do you need any help with this, what's left in your opinion so we can get this one ready for review?

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

I'm planning to wrap this up this week, should be ready by Friday.

@GBKSGBKS linked an issue May 6, 2021 that may be closed by this pull request
@GBKSGBKS added this to the Sprint #4 milestone May 6, 2021
@danielnordhdanielnordh changed the title WIP - Bitcoin backups page in FoundationBitcoin backups page in FoundationMay 7, 2021
@danielnordhdanielnordh changed the title Bitcoin backups page in FoundationBitcoin backups page in Private key managementMay 7, 2021
@danielnordh
danielnordh marked this pull request as ready for review May 10, 2021 10:17
@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Due to messed up merge history with this commit I've moved the work over to a fresh PR:
#305

danielnordh added a commit that referenced this pull request May 11, 2021
@danielnordh
danielnordh deleted the bitcoinbackups branch May 11, 2021 12:29
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create page - Recovery backup storage 101

6 participants

@danielnordh@pavlenex@GBKS@johnsBeharry@sbddesign@joseabarreram
, '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('^' + ".*" + ' Bitcoin backups page in Private key management by danielnordh · Pull Request #210 · BitcoinDesign/Guide · GitHub
Skip to content

Bitcoin backups page in Private key management - #210

Closed
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups
Closed

Bitcoin backups page in Private key management#210
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups

Conversation

@danielnordh

@danielnordhdanielnordh commented Apr 2, 2021

Copy link
Copy Markdown
Contributor

PR for issue #139

Adds a page under Private Key Management with a guide to Bitcoin backups.

@GBKSGBKS added the Copy Task is about improving text. label Apr 7, 2021

@pavlenexpavlenex left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@danielnordh

danielnordh commented Apr 9, 2021

Copy link
Copy Markdown
ContributorAuthor

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Agree that this speaks to a different audience, but it was deliberate.
The intention here was to have a guide for end-users that can be a reference.

We could either:

  • Rewrite for the designer/developer audience, who would then have to write the version for the end-user
  • Figure out where 'end-user' facing material could/should live on the site (if at all)

Personally I feel that this kind of guide is absolutely essential to get more people to self-custody.

I'll ignore your detailed comments for now until the audience for this page, and it's place on the site has been agreed.

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh I didn't know it's deliberate, do we expect end-users to visit the design guide and get an education, or should we leave that to other projects? I'm just curious, it's a good document, I just don't feel it's fitting well with the rest of the content that addresses the app creates instead of the end users.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

To weigh in on whether this fits into the guide, I think the content is interesting to both end-users and product-builders. Even us relatively experienced Bitcoiners are struggling with this issue. The fact that several sites exist (Glacier, Yeti, 10x) that also try to tackle this reinforces that this is a need.

I suggest turning this into a mini-project with its own microsite, possible combined with the backup builder concept (add an inheritance sheet also). End-users can use this to help them sort out their backup needs. Designers can learn by studying the different solutions. Product builders can link to this instead of having to create their own guide.

A dedicated microsite would allow for crowd-sourced contributions and localization, making it more widely useful.

We could also turn this into a larger effort that we could call the "Bitcoin User Guide". It could cover more tips (like avoiding address reuse) that are independent of which software or hardware is being used. It would fit with our larger goal of making Bitcoin easier to use.

@pavlenex

Copy link
Copy Markdown
Contributor

@GBKS That's a good idea, but we should talk and consider if too much watering down the Design Guide with too many side-projects is beneficial. At the end of the day, we do want our target audience to be able to find stuff easily, if we keep "side-project" everything, it may influence the ease of navigation and the quality of content in the guide.

This is more general thought though, not specifically 1:1 related to this PR. ^

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Might be a good topic for the "Discussion" page.

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Capturing thoughts from the sprint planning call:

  • Finish up the page, OK to write for end users (preface at the beginning)
  • The content can be taken and re-used in a more accessible form for end-user impact (microsites, existing user-facing sites etc.)
  • Consider whether page makes more sense in Foundations or PKM

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh Do you need any help with this, what's left in your opinion so we can get this one ready for review?

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

I'm planning to wrap this up this week, should be ready by Friday.

@GBKSGBKS linked an issue May 6, 2021 that may be closed by this pull request
@GBKSGBKS added this to the Sprint #4 milestone May 6, 2021
@danielnordhdanielnordh changed the title WIP - Bitcoin backups page in FoundationBitcoin backups page in FoundationMay 7, 2021
@danielnordhdanielnordh changed the title Bitcoin backups page in FoundationBitcoin backups page in Private key managementMay 7, 2021
@danielnordh
danielnordh marked this pull request as ready for review May 10, 2021 10:17
@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Due to messed up merge history with this commit I've moved the work over to a fresh PR:
#305

danielnordh added a commit that referenced this pull request May 11, 2021
@danielnordh
danielnordh deleted the bitcoinbackups branch May 11, 2021 12:29
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create page - Recovery backup storage 101

6 participants

@danielnordh@pavlenex@GBKS@johnsBeharry@sbddesign@joseabarreram
, '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" + ' Bitcoin backups page in Private key management by danielnordh · Pull Request #210 · BitcoinDesign/Guide · GitHub
Skip to content

Bitcoin backups page in Private key management - #210

Closed
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups
Closed

Bitcoin backups page in Private key management#210
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups

Conversation

@danielnordh

@danielnordhdanielnordh commented Apr 2, 2021

Copy link
Copy Markdown
Contributor

PR for issue #139

Adds a page under Private Key Management with a guide to Bitcoin backups.

@GBKSGBKS added the Copy Task is about improving text. label Apr 7, 2021

@pavlenexpavlenex left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@danielnordh

danielnordh commented Apr 9, 2021

Copy link
Copy Markdown
ContributorAuthor

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Agree that this speaks to a different audience, but it was deliberate.
The intention here was to have a guide for end-users that can be a reference.

We could either:

  • Rewrite for the designer/developer audience, who would then have to write the version for the end-user
  • Figure out where 'end-user' facing material could/should live on the site (if at all)

Personally I feel that this kind of guide is absolutely essential to get more people to self-custody.

I'll ignore your detailed comments for now until the audience for this page, and it's place on the site has been agreed.

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh I didn't know it's deliberate, do we expect end-users to visit the design guide and get an education, or should we leave that to other projects? I'm just curious, it's a good document, I just don't feel it's fitting well with the rest of the content that addresses the app creates instead of the end users.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

To weigh in on whether this fits into the guide, I think the content is interesting to both end-users and product-builders. Even us relatively experienced Bitcoiners are struggling with this issue. The fact that several sites exist (Glacier, Yeti, 10x) that also try to tackle this reinforces that this is a need.

I suggest turning this into a mini-project with its own microsite, possible combined with the backup builder concept (add an inheritance sheet also). End-users can use this to help them sort out their backup needs. Designers can learn by studying the different solutions. Product builders can link to this instead of having to create their own guide.

A dedicated microsite would allow for crowd-sourced contributions and localization, making it more widely useful.

We could also turn this into a larger effort that we could call the "Bitcoin User Guide". It could cover more tips (like avoiding address reuse) that are independent of which software or hardware is being used. It would fit with our larger goal of making Bitcoin easier to use.

@pavlenex

Copy link
Copy Markdown
Contributor

@GBKS That's a good idea, but we should talk and consider if too much watering down the Design Guide with too many side-projects is beneficial. At the end of the day, we do want our target audience to be able to find stuff easily, if we keep "side-project" everything, it may influence the ease of navigation and the quality of content in the guide.

This is more general thought though, not specifically 1:1 related to this PR. ^

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Might be a good topic for the "Discussion" page.

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Capturing thoughts from the sprint planning call:

  • Finish up the page, OK to write for end users (preface at the beginning)
  • The content can be taken and re-used in a more accessible form for end-user impact (microsites, existing user-facing sites etc.)
  • Consider whether page makes more sense in Foundations or PKM

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh Do you need any help with this, what's left in your opinion so we can get this one ready for review?

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

I'm planning to wrap this up this week, should be ready by Friday.

@GBKSGBKS linked an issue May 6, 2021 that may be closed by this pull request
@GBKSGBKS added this to the Sprint #4 milestone May 6, 2021
@danielnordhdanielnordh changed the title WIP - Bitcoin backups page in FoundationBitcoin backups page in FoundationMay 7, 2021
@danielnordhdanielnordh changed the title Bitcoin backups page in FoundationBitcoin backups page in Private key managementMay 7, 2021
@danielnordh
danielnordh marked this pull request as ready for review May 10, 2021 10:17
@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Due to messed up merge history with this commit I've moved the work over to a fresh PR:
#305

danielnordh added a commit that referenced this pull request May 11, 2021
@danielnordh
danielnordh deleted the bitcoinbackups branch May 11, 2021 12:29
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create page - Recovery backup storage 101

6 participants

@danielnordh@pavlenex@GBKS@johnsBeharry@sbddesign@joseabarreram
, '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('^' + ".*" + ' Bitcoin backups page in Private key management by danielnordh · Pull Request #210 · BitcoinDesign/Guide · GitHub
Skip to content

Bitcoin backups page in Private key management - #210

Closed
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups
Closed

Bitcoin backups page in Private key management#210
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups

Conversation

@danielnordh

@danielnordhdanielnordh commented Apr 2, 2021

Copy link
Copy Markdown
Contributor

PR for issue #139

Adds a page under Private Key Management with a guide to Bitcoin backups.

@GBKSGBKS added the Copy Task is about improving text. label Apr 7, 2021

@pavlenexpavlenex left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@danielnordh

danielnordh commented Apr 9, 2021

Copy link
Copy Markdown
ContributorAuthor

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Agree that this speaks to a different audience, but it was deliberate.
The intention here was to have a guide for end-users that can be a reference.

We could either:

  • Rewrite for the designer/developer audience, who would then have to write the version for the end-user
  • Figure out where 'end-user' facing material could/should live on the site (if at all)

Personally I feel that this kind of guide is absolutely essential to get more people to self-custody.

I'll ignore your detailed comments for now until the audience for this page, and it's place on the site has been agreed.

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh I didn't know it's deliberate, do we expect end-users to visit the design guide and get an education, or should we leave that to other projects? I'm just curious, it's a good document, I just don't feel it's fitting well with the rest of the content that addresses the app creates instead of the end users.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

To weigh in on whether this fits into the guide, I think the content is interesting to both end-users and product-builders. Even us relatively experienced Bitcoiners are struggling with this issue. The fact that several sites exist (Glacier, Yeti, 10x) that also try to tackle this reinforces that this is a need.

I suggest turning this into a mini-project with its own microsite, possible combined with the backup builder concept (add an inheritance sheet also). End-users can use this to help them sort out their backup needs. Designers can learn by studying the different solutions. Product builders can link to this instead of having to create their own guide.

A dedicated microsite would allow for crowd-sourced contributions and localization, making it more widely useful.

We could also turn this into a larger effort that we could call the "Bitcoin User Guide". It could cover more tips (like avoiding address reuse) that are independent of which software or hardware is being used. It would fit with our larger goal of making Bitcoin easier to use.

@pavlenex

Copy link
Copy Markdown
Contributor

@GBKS That's a good idea, but we should talk and consider if too much watering down the Design Guide with too many side-projects is beneficial. At the end of the day, we do want our target audience to be able to find stuff easily, if we keep "side-project" everything, it may influence the ease of navigation and the quality of content in the guide.

This is more general thought though, not specifically 1:1 related to this PR. ^

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Might be a good topic for the "Discussion" page.

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Capturing thoughts from the sprint planning call:

  • Finish up the page, OK to write for end users (preface at the beginning)
  • The content can be taken and re-used in a more accessible form for end-user impact (microsites, existing user-facing sites etc.)
  • Consider whether page makes more sense in Foundations or PKM

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh Do you need any help with this, what's left in your opinion so we can get this one ready for review?

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

I'm planning to wrap this up this week, should be ready by Friday.

@GBKSGBKS linked an issue May 6, 2021 that may be closed by this pull request
@GBKSGBKS added this to the Sprint #4 milestone May 6, 2021
@danielnordhdanielnordh changed the title WIP - Bitcoin backups page in FoundationBitcoin backups page in FoundationMay 7, 2021
@danielnordhdanielnordh changed the title Bitcoin backups page in FoundationBitcoin backups page in Private key managementMay 7, 2021
@danielnordh
danielnordh marked this pull request as ready for review May 10, 2021 10:17
@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Due to messed up merge history with this commit I've moved the work over to a fresh PR:
#305

danielnordh added a commit that referenced this pull request May 11, 2021
@danielnordh
danielnordh deleted the bitcoinbackups branch May 11, 2021 12:29
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create page - Recovery backup storage 101

6 participants

@danielnordh@pavlenex@GBKS@johnsBeharry@sbddesign@joseabarreram
, '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); } })(); })(); Bitcoin backups page in Private key management by danielnordh · Pull Request #210 · BitcoinDesign/Guide · GitHub
Skip to content

Bitcoin backups page in Private key management - #210

Closed
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups
Closed

Bitcoin backups page in Private key management#210
danielnordh wants to merge 243 commits into
masterfrom
bitcoinbackups

Conversation

@danielnordh

@danielnordhdanielnordh commented Apr 2, 2021

Copy link
Copy Markdown
Contributor

PR for issue #139

Adds a page under Private Key Management with a guide to Bitcoin backups.

@GBKSGBKS added the Copy Task is about improving text. label Apr 7, 2021

@pavlenexpavlenex left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@danielnordh

danielnordh commented Apr 9, 2021

Copy link
Copy Markdown
ContributorAuthor

@danielnordh I like the general idea behind this.

I've started doing a bit closer review at first, but I then realized there are some structural issues that I feel we can address here. For starters, this whole section talks to the end-user directly. It doesn't really talk to our target audience, designers/developers. What this should do is teach the target audience how to "teach" or present this to the user, and that's the biggest missing gap to me. Lots of do's and don't actually tell end-user what to do, which felt a bit off.

The structure itself and the suggestions are good (there are some choices I am not sure I agree with ex storing seed in a jar, but that can be ironed out later on.

Agree that this speaks to a different audience, but it was deliberate.
The intention here was to have a guide for end-users that can be a reference.

We could either:

  • Rewrite for the designer/developer audience, who would then have to write the version for the end-user
  • Figure out where 'end-user' facing material could/should live on the site (if at all)

Personally I feel that this kind of guide is absolutely essential to get more people to self-custody.

I'll ignore your detailed comments for now until the audience for this page, and it's place on the site has been agreed.

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh I didn't know it's deliberate, do we expect end-users to visit the design guide and get an education, or should we leave that to other projects? I'm just curious, it's a good document, I just don't feel it's fitting well with the rest of the content that addresses the app creates instead of the end users.

Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
Comment threadguide/foundations/backups.md Outdated
@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

To weigh in on whether this fits into the guide, I think the content is interesting to both end-users and product-builders. Even us relatively experienced Bitcoiners are struggling with this issue. The fact that several sites exist (Glacier, Yeti, 10x) that also try to tackle this reinforces that this is a need.

I suggest turning this into a mini-project with its own microsite, possible combined with the backup builder concept (add an inheritance sheet also). End-users can use this to help them sort out their backup needs. Designers can learn by studying the different solutions. Product builders can link to this instead of having to create their own guide.

A dedicated microsite would allow for crowd-sourced contributions and localization, making it more widely useful.

We could also turn this into a larger effort that we could call the "Bitcoin User Guide". It could cover more tips (like avoiding address reuse) that are independent of which software or hardware is being used. It would fit with our larger goal of making Bitcoin easier to use.

@pavlenex

Copy link
Copy Markdown
Contributor

@GBKS That's a good idea, but we should talk and consider if too much watering down the Design Guide with too many side-projects is beneficial. At the end of the day, we do want our target audience to be able to find stuff easily, if we keep "side-project" everything, it may influence the ease of navigation and the quality of content in the guide.

This is more general thought though, not specifically 1:1 related to this PR. ^

@GBKS

GBKS commented Apr 15, 2021

Copy link
Copy Markdown
Contributor

Might be a good topic for the "Discussion" page.

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Capturing thoughts from the sprint planning call:

  • Finish up the page, OK to write for end users (preface at the beginning)
  • The content can be taken and re-used in a more accessible form for end-user impact (microsites, existing user-facing sites etc.)
  • Consider whether page makes more sense in Foundations or PKM

@pavlenex

Copy link
Copy Markdown
Contributor

@danielnordh Do you need any help with this, what's left in your opinion so we can get this one ready for review?

@danielnordh

Copy link
Copy Markdown
ContributorAuthor

I'm planning to wrap this up this week, should be ready by Friday.

@GBKSGBKS linked an issue May 6, 2021 that may be closed by this pull request
@GBKSGBKS added this to the Sprint #4 milestone May 6, 2021
@danielnordhdanielnordh changed the title WIP - Bitcoin backups page in FoundationBitcoin backups page in FoundationMay 7, 2021
@danielnordhdanielnordh changed the title Bitcoin backups page in FoundationBitcoin backups page in Private key managementMay 7, 2021
@danielnordh
danielnordh marked this pull request as ready for review May 10, 2021 10:17
@danielnordh

Copy link
Copy Markdown
ContributorAuthor

Due to messed up merge history with this commit I've moved the work over to a fresh PR:
#305

danielnordh added a commit that referenced this pull request May 11, 2021
@danielnordh
danielnordh deleted the bitcoinbackups branch May 11, 2021 12:29
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CopyTask is about improving text.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create page - Recovery backup storage 101

6 participants

@danielnordh@pavlenex@GBKS@johnsBeharry@sbddesign@joseabarreram