*Umbraco Best Cog Practices
Who Am I?
Marcin Zajkowski
Umbraco Developer, Trainer and Certified Master @ The Cogworks
Team, Technology & Knowledge Wizard (CKO, CIO) / PedagoGEEK @ WOW School
Me @ udfnd.pl
@zajkowskimarcin
@zajkowskimarcin
marcin.zajkowski@thecogworks.com
- Our Umbraco: http://our.umbraco.org/
- Community Slack: http://umbracians.chat/
- Slides: https://slides.com/zajkowskimarcin/umbraco-best-practices/
So... best practices huh?
Sign up for official
Umbraco Trainings!
Thank You! Questions?
@zajkowskimarcin / marcin.zajkowski@thecogworks.com
We are The Cogworks 💪
Skilled & Experieced Team
Anthony Dang
Ismail Mayat
Callum Whyte
Umbraco Exp++
Some of our Clients
Community Contrib
People, not technology.
Psst... save the date and visit Poland!
September 15th, Cracow
Meetups
...cause sharing is caring!
Packages
Ok...so let's play
a game!
Coding Standards
Done Right :)
Naming Conventions
Consistent Indentation
Tabs vs. Spaces
Comments
Nesting
Line Lenght
File and Folder Structure
Code Smells
Architecture & Design Patterns
→ Coding Standards done wrong
→ Takeaways
Coding Standards
Done Wrong :[
Naming Conventions?
Inconsistent Indentation
Tabs vs. Spaces
Comments
Nesting
Line Lenght
File and Folder Structure
Code Smells
Architecture & Design Patterns
→ Coding Standards done right
→ Takeaways
Coding Standards
Takeaways
Be consistent.
Simple is perfect.
Avoid overengineering.
Packages
Umbraco != Wordpress
Use packages only when built-in features are not enough.
Our must-haves
- Umbraco Core Property Value Converters (inside Umbraco Core from 7.6 - btw. grab the RC!)
- Nested Content (PR into Core created, due to ???)
- Doc Type Grid Editor / LeBlender
- uSync
- Multi Url Picker (RJP)
- nuPickers
- Models Builder (in Core already for a bit)
Packages should help you achieve the goals, not force you to fight with them.
The whole story behind Find and Replace
Team Management
Done Right :)
Proper / accurate estimations
- Reject or overestimate (MASSIVELY) unknown tasks
- Scale with built in buffering
- T-shirt sizing for new work (Project = 5xM + 7xXL)
- Fibonacci for tasks
- At least 2 or 3 devs doing one estimation
Schedule and capacity
- First of all: measure the points achieved! It's our capacity
- Be realistic !?
- Adjust and be agile
- Don't rush, rushing causes bugs and emergencies
Plan, plan, plan.
Trasparency.
Freedom Fridays!
Team Management
Done Wrong :[
Estimation mistakes
- Underestimated tasks (especially unknowned ones)
- No buffer and spare time to handle emergencies
- No schema for estimating new work (e.g. T-shirt sizings)
- Inconsistent tasks estimations (no schema / points)
- Estimations done by 1 dev (!!!)
Velocity
- Not measured / unknown capacity
- Not being realistic...
- Sticking to "the plan"
- Rushing, pushing = bugs
Starting before thinking / planning.
No transparency.
Overtime work. No freedom.
Maintenance
Done Right :)
Update often.
Leave code a little better than you found it.
Refactoring > Rewriting
Rewriting > Patching
Maintenance
Done Wrong :[
No updates...
No time for refactoring...
Leave code a little better than you found it.
Rewriting > Refactoring
Patching > Rewriting
Automation
DRY / DIE
The same task done multiple times, becomes easier to do for the next time. But... you still need to do it :)
Our Trello Automation
Infrastructure Tool
It helps avoid stupid human errors, but causes some other problems.
Find a balance for yourself.
Documentation
Done Right :)
Documentation is your friend.
Good documentation
- Short
- Easy to read and seek
- May be auto-generated, but it's dangerous
- Needs to be up to date
Create good documentations.
Contribute to
Umbraco docs!
Documentation
Done Wrong :[
Screw documentation,
I know better.
Bad documentation
- Long
- Hard to read and seek
- Not up to date
Don't create bad documentions.
Contribute to
Umbraco docs!
Knowledge Sharing
Done Good :)
Pair Programming FTW!
Meetups, conferences, Our, SO, Slack etc...
Trainings!
Help from your teammates
Don't stop learning and share what you've learned.
Knowledge Sharing
Done Wrong :[
Single points of failure. No pair programming.
Focus on delivering work, rather than expanding knowledge.
Trainings!
Help from your teammates
Don't stop learning and share what you've learned.
Continous Integration
Just do it!
CI / CD Workshops
umbUKFest etc.
SOLID and TDD
Done Good :)
.NET skills
You need to feel ashamed of not doing it.
TDD with Umbraco
Lars Erik + Anthony Dang = Workshops @ CG
SOLID and TDD
Done Wrong :[
Lack of .NET skills
Doing it under pressure not because it's good.
TDD with Umbraco
Lars Erik + Anthony Dang = Workshops @ CG
Use what ya mama (Umbraco) gave ya!
SurfaceControllers
IPublishedContent
ModelsBuilder
The Grid
(olso on steroids!)
Examine
Umbraco Cloud
Summary
- Find or create your own best practices
- Learn from anti-patterns and bad practices
- Learn, share, discover
- Don't complicate stuff - it's not a rocket surgery
- DRY and the others - use packages and community
- Be consistent
Thank You! Questions?
@zajkowskimarcin / marcin.zajkowski@thecogworks.com
* Umbraco Best Cog Practices