yeah, that sounds good. you don't know how people land on a doc page, they might be pretty confused so i think an introduction that sets context and guides to alternatives when there are such important ones make a lot of sense.