Om hjelpesidene

Desse hjelpesidene er Placepoints offisielle brukardokumentasjon, éin samla referanse å slå opp i medan du jobbar. Store delar blir genererte automatisk frå Placepoint Fusion og frå kjeldene vi hentar data frå. Her forklarer vi korleis sidene blir til, og korleis du seier frå når noko ikkje stemmer.

Slik blir sidene bygde

Sidene er bygde med Docusaurus frå Markdown-filer som blir vedlikehaldne av Placepoint-teamet. Kvar endring byggjer alt på nytt og blir publisert til docs.placepoint.no. Det finst inga heiltidsredaksjon, oppdateringar skjer fortløpande, mykje automatisk.

Det meste av arbeidet blir gjort av skript og AI-agentar som brukar Placepoint slik du gjer. Under er delane, og kva som er automatisk i kvar av dei.

Skjermbilete

Hjelpesidene er over 3 500 sider med over 2 900 skjermbilete. Då tel vi med dei omsette sidene og skjermbileta som er tekne på nytt på kvart språk, for dei er eigne sider og eigne bilete. Bileta blir tekne av Playwright: eit skript loggar inn i Placepoint Fusion, navigerer gjennom alle panel og tek bilete av kvart av dei. Endrar ein skjerm seg i produktet, blir turen køyrd på nytt og dei påverka bileta bytte ut. Alle bileta blir tekne i mørkt tema og i same vindaugsstorleik, slik at sidene ser like ut frå topp til botn.

Videoar

14 korte videoar viser dei vanlegaste handlingane, samla på Videoar. Dei blir spelte inn på same måte som skjermbileta: skriptet utfører handlinga i appen og filmar skjermen medan det skjer. Inga tale og inga etterredigering. Kvar video ligg òg på sida som dokumenterer funksjonen han viser.

Tala

Tal om plattforma, som talet på matrikkelenheter og selskap, står samla på Placepoint i tal. Kvart tal blir målt mot databasane bak Placepoint og oppgitt avrunda, fordi eit eksakt tal er utdatert i det det blir publisert. Kvart tal blir henta frå éin stad, og ein automatisk sjekk nektar å publisere ei side som oppgir eit tal vi har bytt ut.

Omsetjingar

Sidene finst på norsk, nynorsk, svensk og engelsk. Omsetjingane blir laga automatisk frå den norske teksten, som er den einaste versjonen som blir skriven og lesen gjennom av menneske. Ein sjekk samanliknar kvar omsette side med den norske kjelda, og publiseringa stoppar viss ei omsetjing manglar eller har blitt liggjande etter ei endring. Finn du noko som skurrar i ei omsetjing, er den norske sida fasit.

Søk

Søkefeltet øvst på kvar side indekserer heile dokumentasjonen, inkludert Ordboken, Data og kjelder og FAQ. Søk på funksjonsnamn ("kartlag", "matching"), fagomgrep ("BRA", "matrikkel") eller heile spørsmål, ofte raskaste veg fram viss du veit kva du leitar etter, men ikkje kvar det står. Søket toler skrivefeil, og det kjenner over 600 synonym på fire språk. Mange av dei er henta ut av sidene sjølve, slik at eit søk på ordet du brukar treffer sida som brukar eit anna.

Ordboken

Ordboken blir skriven her og spegla derifrå til placepoint.no, saman med skjermbiletet som høyrer til omgrepet. Biletet blir publisert frå hjelpesidene og lenkja vidare, så det finst i éi utgåve og kan ikkje bli usamd med seg sjølv. Eit omgrep utan ei flate i Placepoint å vise til får ingen illustrasjon, framfor eit bilete som ikkje høyrer saman med teksten.

Nyheiter

Når ein ny versjon av Placepoint er ute hos kundane, blir det automatisk skrive eit utkast til ei nyheitssak om kva som er nytt. Utkastet blir lese gjennom av ein av oss før det blir publisert, så ingenting går ut usett.

Placepoint API

Placepoint API er REST-API-et som gir dei same dataa som Placepoint Fusion til eit system i staden for til ein person. Det har to sett sider, og begge blir laga av same kjelde: produktsidene under /api/ på norsk, éi per endepunkt, og den tekniske referansen for utviklarar på engelsk, på docs.placepoint.no/developer.

Kjelda er API-kontrakten, ei OpenAPI-skildring av kvart endepunkt: kva parametrar det tek, kva felt det svarar med, kva kvart felt tyder og eit eksempelsvar. Feltlistene, curl-døma og eksempelsvara på sidene blir ikkje skrivne for hand, men bygde frå kontrakten kvar gong sidene blir publiserte. Den tekniske referansen blir generert frå den same fila. Ei side kan dermed ikkje bli usamd med API-et ho skildrar: rettar vi eit felt i kontrakten, endrar begge setta seg i same runde.

Sjekkane rundt dette er strengare enn for resten av dokumentasjonen, fordi nokon byggjer integrasjonar på det som står. Kontrakten blir kontrollert mot våre eigne API-reglar, kvart endepunkt må liggje på nøyaktig éi produktside, produktsida og referansen må lenkje til kvarandre, og ei endring som ville brote ein integrasjon som verkar i dag, stoppar publiseringa. Kva som kan endrast utan varsel, og kor lang tid du har når noko skal fjernast, står på API lifecycle; kvar endring i kontrakten er lista i Changelog.

Endepunkta svarar når API-et er lansert. Leigetakar-API-et svarar allereie, med ein prøvenøkkel du hentar sjølv.

Sidene sjekkar seg sjølve

Før ei endring blir publisert, køyrer 14 automatiske sjekkar over heile dokumentasjonen. Dei nektar mellom anna ei side som lenkjer til ei side som ikkje finst, ei side ingen kjem til frå menyen, eit tal vi har bytt ut, ei omsetjing som er blitt liggjande etter, og eit skjermbilete teke medan kartet framleis lasta. Ein eigen biletsjekk leitar etter blanke kart og halvlasta skjermar, som er den vanlegaste feilen når bileta blir tekne av eit skript.

Sidene er òg lagde til rette for AI-verktøy: llms.txt skildrar innhaldet i eit format språkmodellar kan lese, slik at eit spørsmål stilt til ein AI-assistent kan svarast på med det som faktisk står her.

Ein lengre gjennomgang av korleis delane heng saman står i artikkelen Slik fungerer docs.placepoint.no. Han skildrar systemet slik det var då han blei skriven, og blir mindre presis etter kvart som vi byggjer om.

Kvar informasjonen kjem frå

Innhaldet er sydd saman frå fleire kjelder: funksjonsskildringar og døme blir skrivne av teamet ut frå den køyrande appen; FAQ-en er ei kuratert samling av spørsmål vi ofte får; korte how-to-svar bak det grøne i-ikonet nedst til høgre i Placepoint dekkjer dei same funksjonane; Ordboken forklarer over 300 omgrep frå eigedom, regulering og bygg, rikare med lenkjer til Lovdata, Kartverket og andre autoritative kjelder; Data og kjelder gir ein motsett inngang som listar datasetta Placepoint kombinerer, kven som leverer dei og kvar du finn dei direkte hos kjelda. Når ei kjelde blir oppdatert, hentar vi inn på nytt og byggjer sidene om.

Kva som kan vere feil

Det meste av sidene blir laga av AI-agentar som faktisk brukar Placepoint Fusion: dei loggar seg inn, klikkar seg gjennom appen, tek skjermbilete undervegs og lærer seg funksjonane bit for bit, med litt hjelp frå oss. Det betyr at dokumentasjonen sjeldan ligg bak produktet, men òg at nokre typar feil kan smyge seg inn:

• Skjermbilete tekne på ein litt rar stad i kartet i forhold til det dei skal vise.
• Skjermbilete som har feila, til dømes der eit kartlag ikkje rakk å laste ferdig før biletet blei teke.
• Tekstar som er litt på sida av røynda og treng menneskeleg finpuss.
• Omgrep eller felt importerte frå eksterne kjelder med småfeil som ikkje er fanga opp enno.
• Lenkjer som peikar på ei flytta underside hos ei datakjelde.

Sei frå når du oppdagar noko. Vi er svært glade for tilbakemeldingar, kvar melding hjelper oss å plukke opp reine feil raskt og prioritere rett kva neste runde skal forbetre.

Hjelp oss å bli betre

Innspel er den raskaste måten sidene blir betre på. Vi vil særleg gjerne høyre kva som manglar eller burde vore betre dokumentert: sei frå viss du leitar etter noko og ikkje finn det, viss eit døme hadde gjort ein funksjon enklare å skjøne, eller viss du sit med ein arbeidsflyt vi ikkje har dekt. Vi tek gjerne imot ønske om både grunnleggjande døme ("korleis finn eg eigar av ein eigedom?") og avanserte ("korleis kombinerer eg matching, overvaking og demografisøk til ein porteføljekandidat-pipeline?"). Gode døme er noko av det mest etterspurde vi har.

Tre kanalar for tilbakemelding, frå kortaste til mest detaljerte:

• "Fant du det du lette etter?", knappen i botnen av kvar einaste hjelpeside. Eitt klikk er nok; ein tilhøyrande kommentar er gull. Vi les kvar einaste tilbakemelding og brukar dei aktivt til å prioritere kva som skal forbetrast neste runde.
• Chat-bobla nedst til høgre går rett til Placepoint-teamet, bruk henne til korte observasjonar. Bemanna i arbeidstida.
• E-post til support@placepoint.no er fint når du vil skrive litt meir eller leggje ved skjermbilete.

Nemner du URL-en til sida det gjeld, finn vi raskt fram.

Placepoint v1, Placepoint Maps (Newsec Maps) og PropCloud

Vi har òg brukardokumentasjon for tre andre Placepoint-flater:

• Placepoint v1, forgjengaren til Placepoint Fusion, framleis i drift på console.placepoint.no.
• PropCloud, søk i eigedommar, selskap og eigarforhold, områdeanalyse og prosjektmapper på app.propcloud.no.
• Placepoint Maps, kart, eigedomsdata og analyseverktøy på app.newsecmaps.com.

Innspel og ønske om desse tre setta blir tekne imot på same måte som her: chat-bobla eller support@placepoint.no.

Eksperiment

Vi har laga nokre små datadrivne eksperiment, meir eller mindre ferdige. Placepoint AI gjer Placepoints data og funksjonalitet tilgjengeleg i Claude, og Agenten gjer det same inne i Placepoint Fusion.