diff --git a/Gemfile b/Gemfile index 72dae01f..6fb28b40 100644 --- a/Gemfile +++ b/Gemfile @@ -28,6 +28,7 @@ group :jekyll_plugins do gem 'jekyll-avatar' gem 'jekyll-titles-from-headings' gem 'jekyll-sitemap' + gem 'jekyll-toc' end group :development do diff --git a/Gemfile.lock b/Gemfile.lock index 9dc40a8f..0391ca7b 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -53,6 +53,8 @@ GEM jekyll (~> 3.3) jekyll-titles-from-headings (0.5.1) jekyll (~> 3.3) + jekyll-toc (0.11.0) + nokogiri (~> 1.9) jekyll-watch (1.5.1) listen (~> 3.0) kramdown (1.17.0) @@ -64,8 +66,11 @@ GEM lumberjack (1.0.13) mercenary (0.3.6) method_source (0.9.0) + mini_portile2 (2.4.0) multipart-post (2.0.0) nenv (0.3.0) + nokogiri (1.10.2) + mini_portile2 (~> 2.4.0) notiffany (0.1.1) nenv (~> 0.1) shellany (~> 0.0) @@ -108,6 +113,7 @@ DEPENDENCIES jekyll-seo-tag jekyll-sitemap jekyll-titles-from-headings + jekyll-toc tzinfo-data RUBY VERSION diff --git a/_community/app-miners-guide.md b/_community/app-miners-guide.md new file mode 100644 index 00000000..c1906ccd --- /dev/null +++ b/_community/app-miners-guide.md @@ -0,0 +1,336 @@ +--- +layout: community +permalink: /:collection/:path.html +toc: true +--- +

A guide featuring insights from App Reviewers and the Blockstack PBC team

+ +

Disclaimer: App Mining is currently being piloted by Blockstack PBC with the intent of refining it to the point it can be implemented at the protocol level on the Stacks Blockchain. The program is constantly improving thanks to feedback collected via the forum, Github, and ongoing App Mining calls with miners.

+ + +## Introduction +{:.no_toc} + +App Mining is built (and constantly refined) in a way that should help bootstrap quality applications that people want to use. As an app improves relative to others in the App Mining pool, so too should its rank and therefore the associated payout. Different independent App Reviewers focus on different aspects of what makes an app high-quality or successful, the aspect they focus on being a function of their expertise. In this guide we'll feature advice from each of these App Reviewers so you can best understand how to score well with each, thus improving your overall score. + +

It's worth noting that if at any point as an App Miner, you feel compelled to do something to improve your score that you don't feel is also improving your app or helping you acquire users, it's a potential area for feedback that could improve App Mining, so please don't hesitate to use the forum or regular call to do so.

+ + +## Before you begin + + + + + + + + + + + + + +
+

Zero-to-Dapp Tutorial

+

If you've found this guide and have not yet built an app, please start with the Zero to Dapp Tutorial. It's the easiest way for anyone to start building on Blockstack. The tutorial will not only help you start building, but will guide you through the App Mining submission process as well!

+
+

How App Mining Rankings Work

+

If you haven't yet, check out these two resources on how the ranking works. It's not required know how everything is calculated, but it's openly shared and calculated in the interest of transparency. This post covers the full process including a video explainer and the white paper. +Recommendations from Blockstack PBC

+
+ +## Recommendations from Blockstack PBC + +### Marketing and Growth + +Don't make Marketing and Growth an afterthought. Content and social media interaction attracts new users. Apps with more users get more feedback. More feedback means better apps. Sooner than later, you'll need to be growing your user base so don't neglect these activities early on as they'll support you in building and maintaining a viable project in the long-term. + +
+
+
+ +

How AppSumo Beat the Tech Giants

+

Download

+
+
+
+
+ +

Free Ebook: The Ultimate How-to Marketing Guide

+

Download

+
+
+
+
+ +

Definitive Guide to 40 Marketing Guides

+

All the Guides

+
+
+
+ +#### Don't lead with 'decentralized' +{:.no_toc} + +Most people don't care how your app works behind the scenes. The decentralized nature of Blockstack and your app is a means to an end. Focus on the value your app provides to your users instead of how it provides it. Show that your app is more secure or private, that users own their data at all times, that their data is not sold, etc. Decentralization will likely come up in describing your app, but don't make the mistake of thinking many will jump at the app simply because it's decentralized. + +#### Do things that don't scale +{:.no_toc} + +Get your hands dirty, do things that don't scale. Paul Graham of Y Combinator recommends this method and it's one that will help you find product market fit faster and more cheaply. Here are a handful of ways to find users that aren't that scalable, but will work. Here's another list of 17 ways to find your first 100 customers. You get the idea, there are more of these out there if you look and it's that kind of hustle that will get your user acquisition kick-started. Beyond that, you'll be learning along the way how to talk about your app the right way—take notes on what works so you can weave those learnings into scalable efforts down the road. + + +#### Publish content and interact +{:.no_toc} + +While there isn't currently a direct measure for number of users, having real users is critical to your success. Not only do they provide the opportunity for you to build a sustainable business, they also provide feedback. Do everything you can to reach new users. In the earliest days, a mix of less scalable activities like those above and the longer-term investment in content is important. Creating content has SEO benefits (people need to find you) in addition to establishing your brand as trustworthy. Create content regularly and distribute it via social networks, groups you're a part of, your personal network, to relevant bloggers and media, investors if you have them, your customers, and other influencers willing to listen. Start with Moz's Beginner's Guide to Content Marketing. + +#### Hone your message +{:.no_toc} + +Chances are the first way you describe your app and its value proposition won't be the most effective ones. Find ways to test what sticks with people and converts new users. A small spend on social or search ads will let you quickly learn what works. You should also experiment with landing pages for specific audiences. There are countless tools to make this easy, you can also pull down free templates for whatever CMS you may be working on. Check out this Beginner's Guide to Landing Pages from Neil Patel and work on the story of your brand/app/project. + +### Design + +With TryMyUI officially onboard, UI is not just important, but a critical piece of the score you receive. + +#### Get more feedback +{:.no_toc} + +In addition to the feedback you'll get each month from TryMyUI, you should gather your own information too. This guide from Help Scout has some great tips for ways you can gather feedback of all kinds from customers. Real people using your app will provide you invaluable feedback. + +#### Keep a close eye on visitor behavior +{:.no_toc} + +Going hand in hand with gathering feedback from users, you should find ways to ethically track website visitors so you can make strategic decisions about where they are falling off in your funnels. Analytics tools such as Fathom, Fullstory, and many more will give you insights, but be sure to take advantage of the options they provide to obfuscate personally identifiable information. Everything from the color of a button, to the image you chose, to the copy you wrote can have an effect on potential new users dropping off. An experienced designer should be able to quickly help you fix problem areas with better design and get more people all the way from your site to into your app. + +#### Invest in graphic design work (even if lightly) +{:.no_toc} + +First impressions of your app (even just the logo appearing on Product Hunt or elsewhere) can be the difference between someone taking your app seriously or just scrolling right past. Quality design work can be found in many places, here's a quick list of resources you can try: + +* Upwork +* Fiverr +* Toptal +* Canva (DIY) +* Graphic River + +## Recommendations from Democracy Earth + +Democracy Earth is a platform for borderless peer-to-peer democracy. They've built vote.blockstack.org for Stacks token holders to cast their vote in the monthly App Mining rankings. It is designed with an understanding that governance is not only about voting, but enabling actual conversations that can lead to growth of the ecosystem as a whole. + +Of all audiences, Stacks token holders are the ones most interested in your success - they are quite literally invested in it. This is an opportunity to form relationships and demonstrate your professionalism and commitment to your work. Many of them are seasoned investors with valuable knowledge to share. Being open to listening is key. + +### The Democracy Earth Score + +Your final score from Democracy Earth is made up of two pieces: + +#### Likability Score +{:.no_toc} + + +This score is all about not getting downvotes (and getting at least 1 upvote). What might cause someone to downvote your application? A downvote might be the result of bugs or bad impressions that a voter has experienced. Poor design could also contribute to this. + +#### Traction Score +{:.no_toc} + +To get a high traction score, you need to get a lot of votes on your app. Votes on Democracy Earth are a scarce resource, but voters can give more than one vote to an app. To get more votes, you need to convince voters that your app is interesting and worth their vote more than other apps. Look at apps that may have received more votes than yours. Are they more interesting, more unique, or better designed? Engaging with voters using the debate section of the platform is encouraged, you can use this feature to find out what voters are looking for and how they think you can improve. + +### How the voters see your app + +Understanding how your app is presented to voters may be helpful. Here's the same instructional video given to voters on how to use the platform and look at your apps: + + +Voting Overview + + +Voting Overview + +### Get the most out of the platform + +Here are some simple recommendations from the team to maximize your chances at scoring well and getting the most information to tangibly improve your app: + + + + + + + + +
+
    +
  • +

    Introduce yourself, and share a little about your app, the team and story behind it. You want it to give an overview that Stack’s token holders wouldn’t be able to get elsewhere, but also make sure to keep it concise and to the point.

    +
    • +
  • +

    Leverage Markdown. You can post links, images and videos. Make sure to add social media links that can point out how actively you are promoting your app, and - with the caveat that all conversations are public - feel free to share your own contact information as well.

    +
    • +
  • +

    This is basic, but some App Founders forget it: don’t leave questions unanswered. Every question is an opportunity to engage + voters and share more about your work, and a thoughtful answer can be the beginning of a closer relationship with a Stacks token holder.

    +
    • +
  • +

    Welcome positive and negative feedback equally - both are intended for your growth!

    +
    • +
+		 +Voting Overview +
+ +Democracy Earth is constantly iterating to make vote.blockstack.org a better tool. If you have any feedback, please share with appmining@democracy.earth. + +## Recommendations from Product Hunt + +### Product Hunt Community Score + +The community score is calculated directly from public upvotes on Product Hunt. This community serves as a good indicator of how your app will be perceived by early adopters and people who are actively looking for new solutions. Although your best opportunity to get upvotes is from a good launch on Product Hunt, you can continue to get upvotes forever. + +### Resources + + +Maximizing your launch: Since your launch on Product Hunt is such a great opportunity to start your Community Score on the right foot, we recommend following the extensive launch guide Product Hunt has put together. It will help you navigate a the do's and don'ts of launch and provide other helpful marketing tips. It covers: + +* How to launch on Product Hunt +* The key things to focus on +* What to avoid doing +* How to prepare in advance +* How to market your product + +**Bonus Section**: How to get promoted by the official Product Hunt Twitter and Facebook accounts, and how to make it into the Newsletter which reaches hundreds of thousands of readers every day (even after your launch). + + + + + + +
+

How to Launch on Product Hunt ????

+

There are dozens of different articles and posts, each promising to be the "Ultimate Guide to launching on Product Hunt." While the intentions of the authors are good and most of the recommendations accurate, each article unwittingly contains misinformation that we'll address throughout this post.

+

Learn more

+
+ +#### Easy ways to get more upvotes even after launch +{:.no_toc} + + +* Use the upvote widget from Product Hunt +* Get your app listed on popular collections to increase visibility +* Link to your Product Hunt page from your social media accounts or website +* Expand the content on your Product Hunt page to appear in more search results and give people the information they're looking for + +## Recommendations from TryMyUI + +### The TryMyUI Score + +TryMyUI's panelists will score using a special survey they developed expressly for the App Mining program: the ALF Questionnaire (Adoption Likelihood Factors). Answers to this questionnaire will be used to calculate an overall score reflecting the following 4 factors: + + + + + + +
+
    +
  1. Usability: Is the app intuitive and easy to interact with? Can users perform the central functions without difficulty?
    2. +
  2. Usefulness: Does the app meet a real need? Does it provide a valuable solution to a problem that users face?
    3. +
  3. Credibility: Does the app inspire trust in users? Do they feel that it is safe to use? Does the information on the app feel authoritative and believable?
    4. +
  4. Desirability: Do users enjoy being on the app? Does it make them want to return for future use? Are they excited about the app and what it allows them to do?
    5. +
+
+ +Each factor corresponds to 4 questionnaire items, for a total 16 items that comprise the ALFQ. Users mark their answers on a 5-point Likert scale, with 5 meaning "Strongly agree" and 1 meaning "Strongly disagree." The final result is a score for each of the 4 factors, and a composite ALF score. + +### What to do with your TryMyUI videos & data + +Every month after the scores are released, you will be given access to 8 user videos from your app, with the accompanying ALF scores and written survey responses. This data will contain deep insights into the User Experience of your app – what you're doing well, and where you can improve. +All of this will be really helpful over the next few weeks as you work to improve your app design for the next month's round of testing. Here's our tips for diving into your TryMyUI test data: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TipDescription
Check your ALF scores first.You'll be able to see each individual tester's score. Check who had the best and worst experiences. This will be helpful to know before you start watching the videos.
Scan your written survey responses. Look for themes that appear across multiple testers' answers. Keep an eye out for any glaring issues that may have specially impacted users' experiences.
Formulate an attack plan.Now that you've reviewed the ALF scores and written responses, start watching your videos. You already have an idea of the kinds of issues you'll find, and which users experienced those issues, so start there. This will allow you to quickly identify your main areas for improvement, and to understand why users are having trouble in those spots.
Take notes.As you watch your videos, take notes on what you see. Users will give verbal feedback as they go, explaining their thoughts, reactions, and impressions of your app. Look in particular for gaps between what they expected and the actual experience your app delivered.
Read between the lines.Observe what users do as well as what they say. The verbal feedback is important, but sometimes users won't comment on every issue, or even realize that something has gone wrong! Pay close attention to behaviors that are different from what you anticipated, or things that are hindering users' progress towards your desired outcomes.
Interpret your findings.Figure out what users' feedback means for your roadmap by identifying the problem at the root of their complaints. For example, a user might wish for a video tutorial, but that doesn't necessarily mean you should add a video tutorial. Instead, think about what's missing from the information you currently provide that caused the user to feel so disoriented.
Look for positives too!Your TryMyUI data won't just show you where things aren't working smoothly, it will also show you what you're doing right. It's important to take note of these insights, so you can emphasize those elements and avoid eliminating features that people like. +
+ +### UI/UX Recommendations + +Here are some quick tips from the TryMyUI team on improving your app's design and providing better experiences for your users: + +* First impressions matter! Clearly communicate your main value proposition up front. If visitors don't understand what you can do for them, they won't even bother moving on to the next step. + +* Pretty isn't everything, but a visually attractive design increases your credibility and makes users feel more comfortable using your app. A good-looking homepage will start you off on the right foot with users. + +* Show, don't tell. People never read as much as you think. Wherever possible, try to explain your app's benefits and functionalities with a combination of text, illustration, and interaction. + +* Define user personas and stories, and design your app based on these. If you can step into the shoes of your users, you'll be better able to create something they'll want to use. + +* Simplify. Trim the fat in your designs. Simple is better – focus on the main actions, and minimize distractions. + +### Analyzing and improving your UX + +
+
+
+ +

TryMyUI.com

+

Understanding first impressions on your site

+

Read More

+
+
+
+
+ +

TryMyUI.com

+

5 psychology principles for better UX design

+

Read More

+
+
+
+
+ +

Smashing Magazine

+

A Comprehensive Guide To Mobile App Design

+

See the Guide

+
+
+
+ + +## Thank you! +{:.no_toc} + + +We hope you enjoyed this guide and are enjoying your App Mining experience. Please contact mining@app.co at any time with suggestions or questions. diff --git a/_community/images/alf-score.png b/_community/images/alf-score.png new file mode 100644 index 00000000..1830f44c Binary files /dev/null and b/_community/images/alf-score.png differ diff --git a/_community/images/appsumo.jpg b/_community/images/appsumo.jpg new file mode 100644 index 00000000..f6c970f3 Binary files /dev/null and b/_community/images/appsumo.jpg differ diff --git a/_community/images/business-camera-coff.jpg b/_community/images/business-camera-coff.jpg new file mode 100644 index 00000000..9674dbdf Binary files /dev/null and b/_community/images/business-camera-coff.jpg differ diff --git a/_community/images/dark.jpg b/_community/images/dark.jpg new file mode 100644 index 00000000..4b653583 Binary files /dev/null and b/_community/images/dark.jpg differ diff --git a/_community/images/flowers.png b/_community/images/flowers.png new file mode 100644 index 00000000..6e954da5 Binary files /dev/null and b/_community/images/flowers.png differ diff --git a/_community/images/hubspot.png b/_community/images/hubspot.png new file mode 100644 index 00000000..cb1dbc22 Binary files /dev/null and b/_community/images/hubspot.png differ diff --git a/_community/images/image_preview.png b/_community/images/image_preview.png new file mode 100644 index 00000000..9bcebad5 Binary files /dev/null and b/_community/images/image_preview.png differ diff --git a/_community/images/image_preview_1.png b/_community/images/image_preview_1.png new file mode 100644 index 00000000..5886f850 Binary files /dev/null and b/_community/images/image_preview_1.png differ diff --git a/_community/images/launch.png b/_community/images/launch.png new file mode 100644 index 00000000..e0a3517a Binary files /dev/null and b/_community/images/launch.png differ diff --git a/_community/images/pineapple.png b/_community/images/pineapple.png new file mode 100644 index 00000000..d113260b Binary files /dev/null and b/_community/images/pineapple.png differ diff --git a/_community/images/video-1.png b/_community/images/video-1.png new file mode 100644 index 00000000..187aa8eb Binary files /dev/null and b/_community/images/video-1.png differ diff --git a/_community/images/your-app.png b/_community/images/your-app.png new file mode 100644 index 00000000..88c8346f Binary files /dev/null and b/_community/images/your-app.png differ diff --git a/_community/images/zero-to-dapp.png b/_community/images/zero-to-dapp.png new file mode 100644 index 00000000..511bb372 Binary files /dev/null and b/_community/images/zero-to-dapp.png differ diff --git a/_config.yml b/_config.yml index 698f0798..331bdec0 100644 --- a/_config.yml +++ b/_config.yml @@ -95,6 +95,9 @@ kramdown: input: GFM auto_ids: true syntax_highlighter: rouge +toc: + min_level: 2 # default: 1 + max_level: 3 # default: 6 plugins: - jekyll-feed @@ -103,6 +106,7 @@ plugins: - jekyll-avatar - jekyll-titles-from-headings - jekyll-sitemap + - jekyll-toc titles_from_headings: enabled: true @@ -163,6 +167,9 @@ collections: android: output: true basepath: "blockstack/blockstack-android/blob/master/docs" + community: + output: true + basepath: "blockstack/blockstack-core/blob/master/docs" core: output: true basepath: "blockstack/blockstack-core/blob/master/docs" diff --git a/_data/navigation_learn.yml b/_data/navigation_learn.yml index 6922d8dc..ee7d540a 100644 --- a/_data/navigation_learn.yml +++ b/_data/navigation_learn.yml @@ -28,6 +28,7 @@ - develop/mining_intro - develop/mining_enroll - develop/vote-blockstack + - community/app-miners-guide - develop/appMiningFAQ diff --git a/_develop/vote-blockstack.md b/_develop/vote-blockstack.md index 4597d940..bbaa7987 100644 --- a/_develop/vote-blockstack.md +++ b/_develop/vote-blockstack.md @@ -106,7 +106,7 @@ To create a voter profile, do the following: 3. Agree to the App Mining Voting Terms. 4. Select the **Blockstack ID** button. - The system prompts you for a blockstack identity. You may be already signed into the Blockstack Browser with an identity; you can use this one or another. If you do not have a Blockstack identity, you should choose to **Create new ID**, creating an identity can take time. After creating an identity, return to this procedure. + The system prompts you for a blockstack identity. You may be already signed into the Blockstack Browser with an identity; you can use this one or another. If you do not have a Blockstack identity, you should choose to **Create new ID**, creating an identity can take time. After creating an identity, return to this procedure. 5. Authenticate with a Blockstack ID. diff --git a/_develop/zero_to_dapp_4.md b/_develop/zero_to_dapp_4.md index 498ccd34..4a587ab5 100644 --- a/_develop/zero_to_dapp_4.md +++ b/_develop/zero_to_dapp_4.md @@ -121,7 +121,7 @@ To add an app, do the following: Only applications that integrate Blockstack authentication and that are accessible to review can participate in application mining (App Mining). -To submit an application for App Mining, you select App Mining from the App.co menu and then select the **Submit your app for qualification** button. Blockstack sample applications that you create from our tutorials such as this one don't qualify for application mining. +To submit an application for App Mining, you select App Mining from the App.co menu and then select the **Submit your app for qualification** button. Blockstack sample applications that you create from our tutorials such as this one don't qualify for application mining. Your submission is evaluated internally to check if it passes the basic requirements. After it passes, we accept the app and contact you to submit diff --git a/_layouts/community.html b/_layouts/community.html new file mode 100644 index 00000000..7e4001ca --- /dev/null +++ b/_layouts/community.html @@ -0,0 +1,54 @@ +--- +layout: default +--- + +
+
+
+ +
+
+

 

+ {{ content | toc_only }} +
+
+ +
+ +
+ +

{{ page.title | escape }}

+ + {% if page.subtitle %}

{{ page.subtitle }}

{% endif %} + + +
+ {% include post-meta.html %} +
+ +
+ {{ content }} + {% include share.html %} + {% include footer.html %} +
+ +
+ + {% include paginate-doc.html %} + + + +
+ + + +
+ +
+
diff --git a/_layouts/page.html b/_layouts/page.html index d7e5e171..01568d80 100644 --- a/_layouts/page.html +++ b/_layouts/page.html @@ -3,7 +3,7 @@ layout: default ---
-
+
diff --git a/_sass/theme/variables.scss b/_sass/theme/variables.scss index afc7c784..c004beb0 100644 --- a/_sass/theme/variables.scss +++ b/_sass/theme/variables.scss @@ -1,7 +1,7 @@ // Color scheme variables // Main content -$color-main: #0F1214; +$color-main: #201F6D; // Secondary content $global-muted-color: #7a838a; @@ -28,8 +28,8 @@ $global-medium-font-size: 1.125rem; $global-small-font-size: 0.875rem; // Base -$base-body-color: $color-main; -$base-heading-color: $color-main; +$base-body-color: #0F1214; +$base-heading-color: #0F1214; $link-muted-hover-color: $color-main; $button-primary-hover-background: $color-hover; $base-hr-border: lighten($global-border, 13%);