Om hjälpsidorna

De här hjälpsidorna är Placepoints officiella användardokumentation, en samlad referens att slå upp i medan du arbetar. Stora delar genereras automatiskt från Placepoint Fusion och från de källor vi hämtar data från. Här förklarar vi hur sidorna blir till och hur du kan säga ifrån om något inte stämmer.

Så byggs sidorna

Sidorna är byggda med Docusaurus från Markdown-filer som underhålls av Placepoint-teamet. Varje ändring bygger om allt och publiceras till docs.placepoint.no. Det finns ingen heltidsredaktion, uppdateringar sker löpande och mycket av det automatiskt.

Det mesta av arbetet görs av skript och AI-agenter som använder Placepoint på samma sätt som du. Nedan är delarna, och vad som är automatiskt i var och en av dem.

Skärmdumpar

Hjälpsidorna är över 3 500 sidor med över 2 900 skärmdumpar. Då räknar vi med de översatta sidorna och de skärmdumpar som tagits om på varje språk, eftersom de är egna sidor och egna bilder. Bilderna tas av Playwright: ett skript loggar in i Placepoint Fusion, navigerar genom alla paneler och tar en bild av var och en av dem. Ändras en skärm i produkten körs turen om och de berörda bilderna byts ut. Alla bilder tas i mörkt tema och i samma fönsterstorlek, så att sidorna ser likadana ut från topp till botten.

Videor

14 korta videor visar de vanligaste åtgärderna, samlade på Videor. De spelas in på samma sätt som skärmdumparna: skriptet utför åtgärden i appen och filmar skärmen medan det sker. Inget tal och ingen efterredigering. Varje video ligger också på sidan som dokumenterar funktionen den visar.

Talen

Tal om plattformen, som antal matrikkelenheter och bolag, står samlade på Placepoint i tal. Varje tal mäts mot databaserna bakom Placepoint och anges avrundat, eftersom ett exakt tal är föråldrat i samma stund som det publiceras. Varje tal hämtas från ett ställe, och en automatisk kontroll vägrar publicera en sida som anger ett tal vi har bytt ut.

Översättningar

Sidorna finns på norska, nynorska, svenska och engelska. Översättningarna görs automatiskt från den norska texten, som är den enda versionen som skrivs och läses igenom av människor. En kontroll jämför varje översatt sida med den norska källan, och publiceringen stoppas om en översättning saknas eller har blivit liggande efter en ändring. Hittar du något som skaver i en översättning är den norska sidan facit.

Sök

Sökfältet högst upp på varje sida indexerar hela dokumentationen, inklusive Ordboken, Data och källor och FAQ. Sök på funktionsnamn ("kartlager", "matchning"), fackbegrepp ("BOA", "matrikkel") eller hela frågor. Det är ofta snabbaste vägen fram om du vet vad du letar efter, men inte var det står. Söket tål stavfel och det känner till över 600 synonymer på fyra språk. Många av dem är hämtade ur sidorna själva, så att en sökning på det ord du använder träffar sidan som använder ett annat.

Ordboken

Ordboken skrivs här och speglas därifrån till placepoint.no, tillsammans med skärmbilden som hör till begreppet. Bilden publiceras från hjälpsidorna och länkas vidare, så den finns i en enda version och kan inte bli oense med sig själv. Ett begrepp utan en yta i Placepoint att visa till får ingen illustration, hellre det än en bild som inte hör ihop med texten.

Nyheter

När en ny version av Placepoint är ute hos kunderna skrivs automatiskt ett utkast till en nyhet om vad som är nytt. Utkastet läses igenom av någon av oss innan det publiceras, så ingenting går ut osett.

Placepoint API

Placepoint API är det REST-API som ger samma data som Placepoint Fusion till ett system i stället för till en person. Det har två uppsättningar sidor, och båda görs av samma källa: produktsidorna under /api/ på norska, en per endpoint, och den tekniska referensen för utvecklare på engelska, på docs.placepoint.no/developer.

Källan är API-kontraktet, en OpenAPI-beskrivning av varje endpoint: vilka parametrar den tar, vilka fält den svarar med, vad varje fält betyder och ett exempelsvar. Fältlistorna, curl-exemplen och exempelsvaren på sidorna skrivs inte för hand, utan byggs från kontraktet varje gång sidorna publiceras. Den tekniska referensen genereras från samma fil. En sida kan därmed inte bli oense med det API den beskriver: rättar vi ett fält i kontraktet ändras båda uppsättningarna i samma omgång.

Kontrollerna kring detta är strängare än för resten av dokumentationen, eftersom några bygger integrationer på det som står. Kontraktet kontrolleras mot våra egna API-regler, varje endpoint måste ligga på exakt en produktsida, produktsidan och referensen måste länka till varandra, och en ändring som skulle ha brutit en integration som fungerar i dag stoppar publiceringen. Vad som kan ändras utan förvarning, och hur lång tid du har när något ska tas bort, står på API lifecycle; varje ändring i kontraktet är listad i Changelog.

Endpointerna svarar när API:et är lanserat. Hyresgäst-API:et svarar redan, med en provnyckel som du hämtar själv.

Sidorna kontrollerar sig själva

Innan en ändring publiceras körs 14 automatiska kontroller över hela dokumentationen. De vägrar bland annat en sida som länkar till en sida som inte finns, en sida ingen kommer till från menyn, ett tal vi har bytt ut, en översättning som blivit liggande efter, och en skärmbild tagen medan kartan fortfarande laddade. En egen bildkontroll letar efter tomma kartor och halvladdade skärmar, vilket är det vanligaste felet när bilderna tas av ett skript.

Sidorna är också anpassade för AI-verktyg: llms.txt beskriver innehållet i ett format som språkmodeller kan läsa, så att en fråga ställd till en AI-assistent kan besvaras med det som faktiskt står här.

En längre genomgång av hur delarna hänger ihop står i artikeln Så fungerar docs.placepoint.no. Den beskriver systemet som det var när den skrevs, och blir mindre exakt efterhand som vi bygger om.

Var informationen kommer från

Innehållet är sammansatt från flera källor: funktionsbeskrivningar och exempel skrivs av teamet utifrån den körande appen; FAQ:n är en kurerad samling av frågor vi ofta får; korta how-to-svar bakom den gröna i-ikonen nere till höger i Placepoint täcker samma funktioner; Ordboken förklarar över 300 begrepp från fastighet, planer och byggnader, berikade med länkar till Lovdata, Kartverket och andra auktoritativa källor; Data och källor ger en omvänd ingång som listar de datamängder Placepoint kombinerar, vem som levererar dem och var du hittar dem direkt hos källan. När en källa uppdateras hämtar vi in på nytt och bygger om sidorna.

Vad som kan vara fel

Det mesta av sidorna görs av AI-agenter som faktiskt använder Placepoint Fusion: de loggar in, klickar sig genom appen, tar skärmdumpar under tiden och lär sig funktionerna bit för bit, med lite hjälp från oss. Det betyder att dokumentationen sällan ligger efter produkten, men också att vissa typer av fel kan smyga sig in:

• Skärmdumpar tagna på ett lite konstigt ställe i kartan i förhållande till det de ska visa.
• Skärmdumpar som har misslyckats, till exempel där ett kartlager inte hann ladda klart innan bilden togs.
• Texter som är lite vid sidan av verkligheten och behöver mänsklig finputsning.
• Begrepp eller fält importerade från externa källor med småfel som ännu inte har fångats upp.
• Länkar som pekar på en flyttad undersida hos en datakälla.

Säg ifrån när du upptäcker något. Vi är väldigt glada för återkoppling, varje meddelande hjälper oss att snabbt plocka upp rena fel och prioritera rätt vad nästa omgång ska förbättra.

Hjälp oss att bli bättre

Synpunkter är det snabbaste sättet för sidorna att bli bättre. Vi vill särskilt gärna höra vad som saknas eller borde vara bättre dokumenterat: säg ifrån om du letar efter något och inte hittar det, om ett exempel hade gjort en funktion enklare att förstå, eller om du har ett arbetsflöde vi inte har täckt. Vi tar gärna emot önskemål om både grundläggande exempel ("hur hittar jag ägaren till en fastighet?") och avancerade ("hur kombinerar jag matchning, bevakning och demografisök till en pipeline för portföljkandidater?"). Bra exempel är något av det mest efterfrågade vi har.

Tre kanaler för återkoppling, från kortaste till mest detaljerade:

• "Hittade du det du letade efter?", knappen längst ned på varenda hjälpsida. Ett klick räcker, en tillhörande kommentar är guld. Vi läser varenda återkoppling och använder dem aktivt för att prioritera vad som ska förbättras nästa omgång.
• Chattbubblan nere till höger går direkt till Placepoint-teamet, använd den till korta observationer. Bemannad på arbetstid.
• E-post till support@placepoint.no passar bra när du vill skriva lite mer eller bifoga skärmdumpar.

Nämner du webbadressen till sidan det gäller hittar vi snabbt fram.

Placepoint v1, Placepoint Maps (Newsec Maps) och PropCloud

Vi har också användardokumentation för tre andra Placepoint-ytor:

• Placepoint v1, föregångaren till Placepoint Fusion, fortfarande i drift på console.placepoint.no.
• PropCloud, sök i fastigheter, bolag och ägarförhållanden, områdesanalys och projektmappar på app.propcloud.no.
• Placepoint Maps, karta, fastighetsdata och analysverktyg på app.newsecmaps.com.

Synpunkter och önskemål om dessa tre uppsättningar tas emot på samma sätt som här: chattbubblan eller support@placepoint.no.

Experiment

Vi har gjort några små datadrivna experiment, mer eller mindre färdiga. Placepoint AI gör Placepoints data och funktionalitet tillgängliga i Claude, och Agenten gör detsamma inne i Placepoint Fusion.