Om hjelpesidene

Disse hjelpesidene er Placepoints offisielle brukerdokumentasjon, én samlet referanse å slå opp i mens du jobber. Store deler genereres automatisk fra Placepoint Fusion og fra kildene vi henter data fra. Her forklarer vi hvordan sidene blir til, og hvordan du sier fra når noe ikke stemmer.

Slik bygges sidene

Sidene er bygget med Docusaurus fra Markdown-filer som vedlikeholdes av Placepoint-teamet. Hver endring bygger alt på nytt og publiseres til docs.placepoint.no. Det finnes ingen heltidsredaksjon - oppdateringer skjer fortløpende, mye automatisk.

Mesteparten av arbeidet gjøres av skript og AI-agenter som bruker Placepoint slik du gjør. Under er delene, og hva som er automatisk i hver av dem.

Skjermbilder

Hjelpesidene er over 3 500 sider med over 2 900 skjermbilder. Da teller vi de oversatte sidene og skjermbildene som er tatt på nytt på hvert språk, for de er egne sider og egne bilder. Bildene tas av Playwright: et skript logger inn i Placepoint Fusion, navigerer gjennom alle paneler og tar bilde av hvert av dem. Endrer en skjerm seg i produktet, kjøres turen på nytt og de berørte bildene byttes ut. Alle bildene tas i mørkt tema og i samme vindusstørrelse, slik at sidene ser like ut fra topp til bunn.

Videoer

14 korte videoer viser de vanligste handlingene, samlet på Videoer. De spilles inn på samme måte som skjermbildene: skriptet utfører handlingen i appen og filmer skjermen mens det skjer. Ingen tale og ingen etterredigering. Hver video ligger også på siden som dokumenterer funksjonen den viser.

Tallene

Tall om plattformen, som antall matrikkelenheter og selskaper, står samlet på Placepoint i tall. Hvert tall måles mot databasene bak Placepoint og oppgis avrundet, fordi et eksakt tall er utdatert i det det publiseres. Hvert tall hentes fra ett sted, og en automatisk sjekk nekter å publisere en side som oppgir et tall vi har byttet ut.

Oversettelser

Sidene finnes på norsk, nynorsk, svensk og engelsk. Oversettelsene lages automatisk fra den norske teksten, som er den eneste versjonen som skrives og leses gjennom av mennesker. En sjekk sammenligner hver oversatte side med den norske kilden, og publiseringen stopper hvis en oversettelse mangler eller har blitt liggende etter en endring. Finner du noe som skurrer i en oversettelse, er den norske siden fasit.

Søk

Søkefeltet øverst på hver side indekserer hele dokumentasjonen, inkludert Ordboken, Data og kilder og FAQ. Søk på funksjonsnavn ("kartlag", "matching"), fagbegreper ("BRA", "matrikkel") eller hele spørsmål - ofte raskeste vei frem hvis du vet hva du leter etter, men ikke hvor det står. Søket tåler skrivefeil, og det kjenner over 600 synonymer på fire språk. Mange av dem er hentet ut av sidene selv, slik at et søk på ordet du bruker treffer siden som bruker et annet.

Ordboken

Ordboken skrives her og speiles derfra til placepoint.no, sammen med skjermbildet som hører til begrepet. Bildet publiseres fra hjelpesidene og lenkes videre, så det finnes i én utgave og kan ikke bli uenig med seg selv. Et begrep uten en flate i Placepoint å vise til får ingen illustrasjon, framfor et bilde som ikke hører sammen med teksten.

Nyheter

Når en ny versjon av Placepoint er ute hos kundene, skrives det automatisk et utkast til en nyhetssak om hva som er nytt. Utkastet leses gjennom av en av oss før det publiseres, så ingenting går ut usett.

Placepoint API

Placepoint API er REST-API-et som gir de samme dataene som Placepoint Fusion til et system i stedet for til en person. Det har to sett sider, og begge lages av samme kilde: produktsidene under /api/ på norsk, én per endepunkt, og den tekniske referansen for utviklere på engelsk, på docs.placepoint.no/developer.

Kilden er API-kontrakten, en OpenAPI-beskrivelse av hvert endepunkt: hvilke parametre det tar, hvilke felt det svarer med, hva hvert felt betyr og et eksempelsvar. Feltlistene, curl-eksemplene og eksempelsvarene på sidene skrives ikke for hånd, men bygges fra kontrakten hver gang sidene publiseres. Den tekniske referansen genereres fra den samme filen. En side kan dermed ikke bli uenig med API-et den beskriver: retter vi et felt i kontrakten, endrer begge settene seg i samme runde.

Sjekkene rundt dette er strengere enn for resten av dokumentasjonen, fordi noen bygger integrasjoner på det som står. Kontrakten kontrolleres mot våre egne API-regler, hvert endepunkt må ligge på nøyaktig én produktside, produktsiden og referansen må lenke til hverandre, og en endring som ville brutt en integrasjon som virker i dag, stopper publiseringen. Hva som kan endres uten varsel, og hvor lang tid du har når noe skal fjernes, står på API lifecycle; hver endring i kontrakten er listet i Changelog.

Endepunktene svarer når API-et er lansert. Leietaker-API-et svarer allerede, med en prøvenøkkel du henter selv.

Sidene sjekker seg selv

Før en endring publiseres, kjører 14 automatiske sjekker over hele dokumentasjonen. De nekter blant annet en side som lenker til en side som ikke finnes, en side ingen kommer til fra menyen, et tall vi har byttet ut, en oversettelse som er blitt liggende etter, og et skjermbilde tatt mens kartet fortsatt lastet. En egen bildesjekk leter etter blanke kart og halvlastede skjermer, som er den vanligste feilen når bildene tas av et skript.

Sidene er også lagt til rette for AI-verktøy: llms.txt beskriver innholdet i et format språkmodeller kan lese, slik at et spørsmål stilt til en AI-assistent kan besvares med det som faktisk står her.

En lengre gjennomgang av hvordan delene henger sammen står i artikkelen Slik fungerer docs.placepoint.no. Den beskriver systemet slik det var da den ble skrevet, og blir mindre presis etter hvert som vi bygger om.

Hvor informasjonen kommer fra

Innholdet er sydd sammen fra flere kilder: funksjonsbeskrivelser og eksempler skrives av teamet ut fra den kjørende appen; FAQ-en er en kuratert samling av spørsmål vi får ofte; korte how-to-svar bak det grønne i-ikonet nederst til høyre i Placepoint dekker de samme funksjonene; Ordboken forklarer over 300 begreper fra eiendom, regulering og bygg, beriket med lenker til Lovdata, Kartverket og andre autoritative kilder; Data og kilder gir en motsatt inngang som lister datasettene Placepoint kombinerer, hvem som leverer dem og hvor du finner dem direkte hos kilden. Når en kilde oppdateres, henter vi inn på nytt og bygger sidene om.

Hva som kan være feil

Det meste av sidene blir laget av AI-agenter som faktisk bruker Placepoint Fusion: de logger seg inn, klikker seg gjennom appen, tar skjermbilder underveis og lærer seg funksjonene bit for bit, med litt hjelp fra oss. Det betyr at dokumentasjonen sjelden ligger bak produktet, men også at noen typer feil kan smyge seg inn:

• Skjermbilder tatt på et litt rart sted i kartet i forhold til det de skal vise.
• Skjermbilder som har feilet, for eksempel der et kartlag ikke rakk å laste ferdig før bildet ble tatt.
• Tekster som er litt på siden av virkeligheten og trenger menneskelig finpuss.
• Begreper eller felt importert fra eksterne kilder med småfeil som ikke er fanget opp ennå.
• Lenker som peker på en flyttet underside hos en datakilde.

Si fra når du oppdager noe. Vi er veldig glade for tilbakemeldinger - hver melding hjelper oss å plukke opp rene feil raskt og prioritere riktig hva neste runde skal forbedre.

Hjelp oss å bli bedre

Innspill er den raskeste måten sidene blir bedre på. Vi vil spesielt gjerne høre hva som mangler eller burde vært bedre dokumentert: si fra hvis du leter etter noe og ikke finner det, hvis et eksempel hadde gjort en funksjon enklere å skjønne, eller hvis du sitter med en arbeidsflyt vi ikke har dekket. Vi tar gjerne imot ønsker om både grunnleggende eksempler ("hvordan finner jeg eier av en eiendom?") og avanserte ("hvordan kombinerer jeg matching, overvåking og demografisøk til en porteføljekandidat-pipeline?"). Gode eksempler er noe av det mest etterspurte vi har.

Tre kanaler for tilbakemelding, fra korteste til mest detaljerte:

• "Fant du det du lette etter?" - knappen i bunnen av hver eneste hjelpeside. Ett klikk er nok; en tilhørende kommentar er gull. Vi leser hver eneste tilbakemelding og bruker dem aktivt til å prioritere hva som skal forbedres neste runde.
• Chat-boblen nederst til høyre går rett til Placepoint-teamet - bruk den til korte observasjoner. Bemannet i arbeidstid.
• E-post til support@placepoint.no er fint når du vil skrive litt mer eller legge ved skjermbilder.

Nevner du URL-en til siden det gjelder, finner vi raskt frem.

Placepoint v1, Placepoint Maps (Newsec Maps) og PropCloud

Vi har også brukerdokumentasjon for tre andre Placepoint-flater:

• Placepoint v1 - forgjengeren til Placepoint Fusion, fortsatt i drift på console.placepoint.no.
• PropCloud - søk i eiendommer, selskaper og eierforhold, områdeanalyse og prosjektmapper på app.propcloud.no.
• Placepoint Maps - kart, eiendomsdata og analyseverktøy på app.newsecmaps.com.

Innspill og ønsker om disse tre settene tas imot på samme måte som her: chat-boblen eller support@placepoint.no.

Eksperimenter

Vi har laget noen små datadrevne eksperimenter, mer eller mindre ferdige. Placepoint AI gjør Placepoints data og funksjonalitet tilgjengelig i Claude, og Agenten gjør det samme inne i Placepoint Fusion.