- Diátaxis is a great way to structure documentation, but I think its real value is in simplifying how we think about writing docs.
It shifts the focus from trying to cram everything into one ‘perfect document’ to recognizing that different users have different needs.
Like, tutorials are for learning by doing, guides are for solving specific problems, reference is for quick lookups, and explanations dive into the ‘why.’
That clarity alone can make one write useful docs.
That being said, sticking too rigidly to any system can be a trap.
- A great companion read is Martin Fowler’s “Accounting Patterns”[1]. Having built and maintained systems that manage financial events for over a decade, I wish I had read these patterns earlier.
- https://helloeffie.com/
Never used it myself but i have been curious if it actually works.
- Article | Software Engineer | Vancouver, BC | ONSITE, VISA | C$90 - C$160 | https://www.article.com
Article is on the mission to engineer remarkably better furniture experiences. To accomplish this goal we manage ourselves relationship with the factories and suppliers, ocean shipping, warehousing, customer service, quality assurance, operations, transportation network and final mile delivers.
We are building software systems to make an impact on each and every aspect of above mentioned areas. We are fast growing startup and we were recently named Canada's fast growing startup[0]. Come help us build remarkably better furniture experiences.
We are hiring for following positions:
Software Engineer, Senior Software Engineer, Principal Software Engineer
See more details at https://www.article.com/careers
[0] https://www.canadianbusiness.com/lists-and-rankings/growth-5...
- Article | Software Engineer, Product Manager | Vancouver, BC | ONSITE, VISA | C$80 - C$150 | https://www.article.com
Article is on the mission to engineer remarkably better furniture experiences. To accomplish this goal we manage ourselves relationship with the factories and suppliers, ocean shipping, warehousing, customer service, quality assurance, operations, transportation network and final mile delivers.
We are building software systems to make an impact on each and every aspect of above mentioned areas. We are 5 year old startup and we are growing at exponential rate. Come help us build remarkably better furniture experiences.
We are hiring for following positions:
Software Engineer
Principal Software Engineer
Product Manager
See more details at https://www.article.com/careers
- Article | Software Engineer, Product Manager | Vancouver, BC | ONSITE, VISA | C$90 - C$140 | https://www.article.com
Article is on the mission to engineer remarkably better furniture experiences. To accomplish this goal we are manage our own factories, ocean shipping, warehousing, customer service, quality assurance, operations, transportation network and final mile delivers.
We are building software systems to make an impact on each and every aspect of above mentioned areas. We are 5 year old startup and we are growing at exponential rate. Come help us build remarkably better furniture experiences.
We are hiring for following positions:
Software Engineer Front End Engineer Principal Software Engineer Product Manager
See more details at https://www.article.com/careers
- If you really care about your customer you should be worried about false positive. I hope as a business you do not cancel customer orders because your fraud detection system has flagged them.
Depending on your scale you may using 3rd parties like Sift science, Stripe Radar or Roll your own fraud detection system.
Flagging orders as potential fraud is the easier part these days. The difficult part is how to come up with a process to verify these flagged orders. This process need to be simple and quick. Because essentially you are saying to your customer we think you are a fraud and can you prove that your not.
Banks merchant checks to verify flagged orders is extremely cumbersome. They require you to call a special phone number (which is different for each bank) provide customer Name, Billing Address, Billing Phone and Credit Information. Then they can only give you a response whether it is a match or not. They can't tell you whether it has been reported stolen or anything else for privacy reason. At scale this is a very time consuming process. It becomes even more cumbersome if you are security conscious business and do not store customer credit card information. In that case you have to communicate with the customer asking them to call you to provide your credit card information again.
There are solutions like 3D Secure but they are not widely supported and adds its own problems. It is high time credit card companies start providing merchant with a 2nd factor check for transaction. For example maybe once a transaction is placed with a merchant. They can trigger a 2nd factor check where by the bank automatically send a code to their email/phone number on file. If the customer is able to provide a correct code merchant can proceed with the order.
Fraud detection will always remain a point of contention between customer and businesses. I just hope business make sensible decision based on their situation. For example I have seen legitimate customer with all the above cases mentioned in the article.
- Article | Software Engineer, Engineering Manager, Product Manager | Vancouver, BC | ONSITE, VISA | C$90 - C$150 | https://www.article.com
Article is on the mission to engineer remarkably better furniture experiences. To accomplish this goal we are manage our own partnership with factories, ocean shipping, warehousing, customer service, quality assurance, operations, transportation network and final mile delivers.
We are building software systems to make an impact on each and every aspect of above mentioned areas. We are a profitable 5 year old startup and we are growing at exponential rate. Come help us build remarkably better furniture experiences.
We are hiring for following positions:
Software Engineer
Principal Software Engineer
Engineering Manager
Product Manager
UI/UX Designer
See more details at https://www.article.com/careers
- "Since Casper launched its “mattress in a box” concept in 2014, digital-savvy entrepreneurs have been launching new mattress brands online seemingly every week."
Casper was not the first mattress in a box online company. But Casper definitely is the first company to get the marketing right.
- I do not have lot of experience in SaaS. I do have experience dealing with conversion rate in ecommerce. I believe you usually cannot compare conversion rate across different businesses in different markets. Comparing SaaS businesses in different markets is like comparing apple and oranges.
- Actually that is not true in BC, Canada. According to BC Emergency Health Services [1], It charges a fee of $50 if transportation is not required. $80 if transportation is required.
- Article (https://www.article.com) | Principal Software Engineer | Vancouver,BC | ONSITE
Hey, we’re Article. We’re a digital-first furniture brand that’s re-engineering the furniture experience one sofa at a time. We don’t have brick and mortar stores, so we’re able to deliver remarkable value on beautiful, modern furniture. Because of this, we’re growing like crazy and we need a few more hands on deck. Maybe it’s you we’re looking for?
We’re looking for a Principal Software Engineer to Lead and own the end to end ownership of architecting, designing, developing, and deploying Article supply chain platform.
You will significantly impact the Article business by:
- Designing and building Article supply chain software platform.
- Being the gatekeeper for the repository by performing code reviews.
- Taking ownership of the up time of all software services. Understand business needs and specs out detail software solutions.
- Being the advocate for good quality code and best practices.
- Improving team velocity by being the force multiplier for the team.
Please feel free to reach out to me personally at tahseen at article.com.
- In my experience Amazon SES is great if you only used it for transactional emails. If you start sending marketing emails you will soon find yourself being blocked by ISPs and email service providers. You will end up spending a considerable amount of time getting yourself unblocked. Some service providers will even block the domain name, so even switching the service won't help you. Everything will go to spam from that domain name.
I have built the tech for an ecommerce startup (https://www.article.com) from scratch. Using different services for transactional and marketing emails is probably one the best decision i made early on.
Pro Tip #1:
"Use a different domain name for the from address while sending out marketing emails"
For example if your primary domain is example.com. Use support@example.com as your from address in transactional emails. Use support@example-mail.com as your from address in your marketing emails. Off course forward all emails received by support@example-mail.com to support@example.com (Why? see Pro Tip #2).
Pro Tip #2:
"Never use fake emails like do-not-reply@example.com for the from address for any email you sent. Yes not even for marketing emails"
You will be surprised how many time customer just reply to emails they have received even if it is an unrelated marketing email. You will regularly see customers receiving a monthly newsletter and they will hit reply asking "Can you change the shipping address on my order?"
- I have being using Chrome Profile(People) feature since they were introduce. It has been a god send for me. I tried Firefox containers for a couple of days here a couple things that will really help:
* Containers need to be per window. Keeping track of containers at Tab level is lot of mental work.
* Set a different default container per device. For example I want to set different default for an office laptop, home computer, shared device, etc.
Firefox is getting there i feel it is just moving too slow for me to make a complete switch.
- Article | Front End Engineer | Vancouver, BC | ONSITE, https://www.article.com
Article is a vertically integrated online furniture brand. I am looking for several Software Engineer to join my development team. Here are some of the exciting problems you can work on while at Article:
1) Traditional furniture companies sends out millions of physical catalogues. We think are inefficient and costly. Can you build the ultimate digital alternate to the physical catalogue?
2) We manage our own Transportation and Deliveries. Can you optimize and automate the warehouse and final mile carrier selection for a shipment?
3) Furniture takes lot of space and they are costly to store and ship. Can you answer the question What product should keep in stock, how much should we keep in stock and where should we stock them?
4) We currently operate our own warehouses. Can you predict where and when should we open our next warehouse?
5) Current generation of warehouse management systems are geared towards small items. Furniture is huge and bulky. Can you design and build an efficient software for managing and shipping furniture at scale?
6) https://www.article.com is the only way to buy our furniture. Can you create a better customer experience?
- Hi, We are a Canadain Startup, but we also have a US corporation as well as we have as we have employees and warehouses in US.
Our System and Network Mamager is Canadian PR but I will like for him to work in US for time to time. He is a Russian Citizen. What kind of VISA we can apply for him to be to work in US?
- A bit of tangent, But i am in the market for the Software that Convoy and CargoFone are building. We have our own FT, LTL and Final Mile Carrier network. We have negotiated custom rates with them.
What i am looking for the Software service through which i send Orders and get updates from these Carriers.
Is there a solution like that out there?
- Article | Front End Engineer | Vancouver, BC | ONSITE, https://www.article.com
Article is a vertically integrated online furniture brand. I am looking for several Software Engineer to join my development team.
Here are some of the exciting problems you can work on while at Article:
1) Traditional furniture companies sends out millions of physical catalogues. We think are inefficient and costly. Can you build the ultimate digital alternate to the physical catalogue?
2) We manage our own Transportation and Deliveries. Can you optimize and automate the warehouse and final mile carrier selection for a shipment?
3) Furniture takes lot of space and they are costly to store and ship. Can you answer the question What product should keep in stock, how much should we keep in stock and where should we stock them?
4) We currently operate our own warehouses. Can you predict where and when should we open our next warehouse?
5) Current generation of warehouse management systems are geared towards small items. Furniture is huge and bulky. Can you design and build an efficient software for managing and shipping furniture at scale?
6) https://www.article.com is the only way to buy our furniture. Can you create a better customer experience?
Let’s talk you can reach me at tahseen [at] article.com
- Article | Software Engineer | Vancouver, BC | ONSITE, https://www.article.com
Article is a vertically integrated online furniture brand. I am looking for several Software Engineer to join my development team.
Here are some of the exciting problems you can work on while at Article:
1) Traditional furniture companies sends out millions of physical catalogues. We think are inefficient and costly. Can you build the ultimate digital alternate to the physical catalogue?
2) We manage our own Transportation and Deliveries. Can you optimize and automate the warehouse and final mile carrier selection for a shipment?
3) Furniture takes lot of space and they are costly to store and ship. Can you answer the question What product should keep in stock, how much should we keep in stock and where should we stock them?
4) We currently operate 3 warehouses. Can you predict where and when should we open our next warehouse?
5) Current generation of warehouse management systems are geared towards small items. Furniture is huge and bulky. Can you design and build an efficient software for managing and shipping furniture at scale?
6) https://www.article.com is the only way to buy our furniture. Can you create a better customer experience?
Let’s talk you can reach me at tahseen [at] article.com
- Article | Software Engineer | Vancouver, BC | ONSITE, https://www.article.com
Article is a vertically integrated online furniture brand. I am looking for several Software Engineer to join my development team.
Here are some of the exciting problems you can work on while at Article:
1) Traditional furniture companies sends out millions of physical catalogues. We think are inefficient and costly. Can you build the ultimate digital alternate to the physical catalogue?
2) We manage our on Transportation and Deliveries. Can you optimize and automate the warehouse and final mile carrier selection for a shipment?
3) Furniture takes lot of space and they are costly to ship. Can you answer the question What product should keep in stock, how much should we keep in stock and where should we stock them?
4) We currently operate 3 warehouses. Can you predict where and when should we open our next warehouse?
5) Current generation of warehouse management systems are geared towards small items. Furniture is huge and bulky. Can you design and build an efficient software for managing and shipping furniture at scale?
6) https://www.article.com is the only way to buy our furniture. Can you create a better customer experience?
Let’s talk you can reach me at tahseen [at] article.com
- Article | Senior Fullstack Developer | Vancouver, BC | REMOTE, ONSITE, https://www.article.com
Article is the leading vertically integrated e-commerce brand for modern furniture. Article is using technology to change how consumers furnish their homes.
Our unique, direct-to-consumer model allows us to deliver stunning, high quality furniture at a fraction of the cost of traditional retailers, and this is winning us fans and customers at a tremendous rate. As we continue this growth we need some incredible people to join our engineering team to help reinvent the furniture industry.
We are looking to add to our rapidly growing Engineering team to lead development of our purchasing, manufacturing, logistics, forecasting, operations management, service automation and end to end customer experience management systems.
Our Philosophy to Technology
- Do things that increases business value.
- Simplicity is more than just a word.
- Automate, Automate and Automate.
- Deploy early and Deploy often.
- Write less code that does more.
What you will be working on
- In-house Purchasing, Manufacturing, Logistics, Operations Management and Service Automation software and systems.
- In-house E-commerce platform including content management, search, navigation, discovery, checkouts, tracking and customer self-serve modules software.
- Analytics and business intelligence systems.
- In-house Marketing Automation modules.
- Future R&D on new technologies to help re-invent online home furnishing.
Tech Stack
- Java, Playframework
- Vue.js, Angular 2, jQuery
- SCSS/CSS
Please apply here https://article.workable.com/jobs/382386
- I might be wrong but it seems like the api is creating one shipment for each package with in an order. I assume that mean you will get a tracking number for each package (Unless tracking number is associated with order, not the shipment in the api). The Scenario I have seen this is not something desirable. UPS[0] and Fedex[1] I believe let you ship up to 20 boxes in one shipment.
[0]https://www.ups.com/content/us/en/resources/sri/glo_mlt_pc.h... [1]http://images.fedex.com/ca_english/businesstools/shipsoftwar...
- Why does your API is making such a big assumption that there is only one parcel/package per shipment[0].
I have looked at your competitors as well. Except for one all of them make this assumption. I guess customers with multi package shipments are not your target clients.
* Invoices: Totals get pushed to a new page with no repeated <thead> header. This is a classic failure of CSS table rendering across page breaks. properties like page-break-inside: avoid are notoriously inconsistent in browser print to PDF engines. Line items get split mid row because the engine doesn't understand the semantic integrity of the data.
* Bills of Lading & Manifests: These documents are infamous for unpredictable page breaks. One page cuts a row in half, the next duplicates headers, the next drops content entirely. This often stems from complex flexbox or grid layouts that the PDF rendering engine struggles to paginate deterministically.
* Shipping Labels: A barcode or QR code shifting by a few pixels is often a DPI or scaling artifact. The browser rendering at a logical 96 DPI doesn't translate perfectly to a 300 or 600 DPI thermal printer format, introducing rounding errors that are catastrophic for scanners. Addresses drift outside the printable area because CSS margins (margin, padding) can be interpreted differently by the print media engine versus the screen engine.
* Digital Forms: This is a classic failure of absolute vs. relative positioning. When you overlay HTML form fields on a scanned PDF background (a common requirement), the HTML box model's flow layout simply cannot guarantee pixel-perfect alignment with the fixed grid of the underlying image. I've seen teams resort to printing, using white out, and hand filling forms because the software couldn't align (x, y) coordinates.
* Tickets & Passes: Scanner rejection due to incorrect sizing is often due to the browser engine's "print scaling" or "fit-to-page" logic, which can be difficult to disable and varies between environments (e.g., a local Docker container vs. an AWS Lambda function with different system fonts or libraries installed).
This always turns into a long tail of support tickets. The only truly reliable solution is to bypass the HTML/CSS rendering model entirely and build the document on a canvas with an absolute coordinate system. This means using libraries like FPDF (PHP), ReportLab (Python), or lower-level tools like iText/PDFBox (Java), where you aren't "converting" a document, you are drawing it. You place text at (x, y), draw a line from (x1, y1) to (x2, y2), and manage page breaks and object placement explicitly.
It's not cheap. The initial build cost is high because every layout is effectively a small, “programmaticd CAD project”. You can't just "throw HTML at it". But the payoff in reliability is immense. It becomes a set and forget system that produces identical documents every time, which stops the endless firefighting.
Yes, two years later it can be painful to update when the original developer is gone. But I would take that trade off any day over constantly battling with imprecise, non deterministic tools. In twenty years of building systems where documents are mission critical, "close enough" rendering was almost never good enough.