Mat MatMoore

Questions

This is a big bit of script, what's the best way to break it up? perhaps have lots of different scripts that are thematically linked and import them?

I guess I would start by making the parts of the script less dependent on each other.

For example, it's usually a bad idea to use global variables, as when you have global variables they can be written to from anywhere in your code, so it will quickly become hard to understand and even if you seperate the code things in one part of the code can have far reaching effects. This includes any variables you read from within a function, but declare in the main body of the script. On the other hand anything that is only assigned to within a function will be local to that function so you know it can't be modified by anything else.

Some ways to deal with global variables:

I don't have much time and I have to change it (p58)

This chapter talks about ways to work around legacy code when you don't have time to refactor first. This happens a lot because it's hard to predict how long adding a feature to legacy code will take, and it's tempting to hack first and leave refactoring till the end (i.e. never).

Before using these techniques, see if you can get the legacy code into a test harness - it may be easier than you think.

If not, these techniques will reduce the risk and/or avoid making the legacy code incrementally worse over time.

The downside compared to refactoring the legacy code is that the legacy code won't go away, and the codebase will accumulate non-legacy bits that duplicate concepts from the legacy code. This is not so bad though, as it encourages further refactoring later as you find yourself reading more tested code.

Clarity

Examples of strong verbs: triggers, issues, generates, specify, omit

occured -> triggered
happens when -> generates
we are very careful to ensure that -> we carefully ensure
a compiler error happens -> the compiler generates an error
a variable declaration doesn't have a datatype -> you declare a variable but don't specify a datatype
errors occur when you leave off a semicolon -> the compiler triggers an error/issues errors when you leave off a semicolon

Why performance matters

HTTP Archive page speed reports
Cost to the user
Web performance optimisation case studies
2012, Page weight matters
2013, Ericson mobility report (Visualiser with 2020 data)
2014, "websites do not need to look exactly the same in every browser"
2014, "there is no fold"
July 2018, Google adds page speed to ranking

How other WYSIWYG editors handle accessibility

Accessibility guidance for authoring tools

Tools covered by https://www.udemy.com/course/react-2nd-edition/learn/lecture/7707740, in the order they're introduced.

Liveserver

A web server

live-server public

	A poem about love, loss, and the universe.

	This is a poem about love, loss, and the universe.
	This is a poem about love, loss, and the universe.
	This is a poem about love, loss, and the universe.
	This is a poem about love, loss, and the universe.
	This is a poem about love, loss, and the universe.
	This is a poem about love, loss, and the universe.
	This is a poem about love, loss, and the universe.
	This is a poem about love, loss, and the universe.

	with course_buckets as (
	select
	course_slug,
	extract(days from open_for_enrolment_at - proposal_submitted_at) as days,
	width_bucket(extract(days from open_for_enrolment_at - proposal_submitted_at), 0, 200,20) as bucket
	from course_creation_milestones
	where open_for_enrolment_at > current_timestamp - interval '3 months'
	),

	bucket_totals as (

	@startuml

	partition Development {
	(*) --> "Write code in development environment"
	"Write code in development environment" --> "Build for development environment"
	"Build for development environment" --> "Deploy to development environment"
	"Deploy to development environment" --> "Manual testing by developers"
	"Manual testing by developers" --> "Push branch to github"
	"Push branch to github" --> "Code review"
	"Code review" --> "Merge code"

	4 tzinfo-data
	4 sass-rails
	4 rails
	3 uglifier
	3 puma
	3 govuk_notify_rails
	3 bootsnap
	2 wicked_pdf
	2 sqlite3
	2 simple_command