microsoft / microsoft/pxt

Print docs in both Color & Black & White

Open
#5,449 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

documentation enhancement
Dominant language
TypeScript
Stars
2.3k
Forks
641
Avg merge
12h 4m
Merged PRs (30d)
57

Description

Currently when we want to print the documentation we get a black & white theme. That makes sense for common printing. But some people may want to print in full color.

We have two problems.

  1. The UI mechanism to allow the users to print both version.

a) We could have a general settings button to establish the default version for printing. (Not very ux friendly)
b) Have two buttons to print (one for color and one for B&W)
c) Have a dropdown in the print button to offer the options (Color, B&W)

  1. If we print in color the contrast and color of the "blocks" might be difficult to read in paper. Like for example pink box with white font next to a red box.

a) Define a set of print colors for the blocks and apply a color CSS sheet
b) Define a set of print safe colors to use across the app so we can use those everywhere.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No file or test is named. Start by locating the documentation print button and its print styling, then review the proposed controls for Color and Black & White output and the block colors. Done means users can choose the intended print version and the colored output remains readable on paper.

Written by the indexing model from the issue text.

Assessment

Tech stack
css, typescript
Domain
design, documentation, frontend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.