more updates

Author: resmo

docs/how/index.md

@@ -1,10 +1,12 @@
 # How to publish Job Openings
 
+There are 5 easy steps to optimize job publishing.
+
 ## 1. Website
 You need **your own website**: e.g. www.example.com, on which you publish your job openings as usual. This can be a [Wordpress](https://wordpress.org/), another CMS, plain HTML or any other way.
 
-## 2. Create a ojobpub.json
-Create file `/.well-known/ojobpub.json` (all lower case!) in a **specific JSON format containing structured meta information** about your job openings and link to the full job description on your website.
+## 2. Create an ojobpub.json
+Create a file `/.well-known/ojobpub.json` (all lower case!) in a **specific JSON format containing structured meta information** about your job openings and link to the full job description on your website.
 
 !!! tip "File or Application?"
     While we have used a static ojobpub.json file to demonstrate the simplest way to provide the data, this endpoint is not limited to a static file. It could just as easily be served by a dynamic application or script.
@@ -15,9 +17,9 @@ To validate the JSON data format, we provide a [oJobPub JSON schema](https://git
 
 ## 4. Let's index
 
-Go to [search.ojobpub.org](https://search.ojobpub.org), enter your domain and **let us index your jobs**! 
+Go to [index.ojobpub.org](https://index.ojobpub.org), enter your domain (fqdn) and **let us index your jobs**! 
 
-This helps us to see, how things are growing. Once this format is known and etablished, this step may become obsolete (hopefully!).
+This helps us to see, how things are growing. Once this format is known and etablished, this step may become obsolete (hopefully!). Job crawlers can get all the domains from us for free using an API.
 
 ## 5. Spread the Word
 

docs/index.md

@@ -1,6 +1,6 @@
 # About oJobPub
 
-oJobPub is an initiative with the goal, to create a free, simple and efficient process to publish on your own website and collect distributed job positions and vacancies around the globe.
+oJobPub is an initiative with the goal, to create a free, simple and efficient process to publish your vacancies on your own website and make it easy, simple and efficient to collect the data for everyone.
 
 ![](static/nutshell.png)
 

docs/solution.md

@@ -1,20 +1,24 @@
 # Our Solution
 
-## Use your own Website
+How we want to address the issues:
 
-So, we ask ourselves:
+- On Your Website
+- Structured Meta Data
+- Well-Known Location
 
-> Why do we even need to post job openings on commercial portals?!
+## On your Website
 
-Actually, we don't! 
+Having a website is almost a given for a company, and the cost of a website has never been lower than it is today.
 
-The **World Wide Web** is a vast, **distributed database** where websites are stored all over the globe, not on a single, centralized platform. 
+We still believe that publishing job vacancies on your **own website is the best and most cost-effective solution**, as you have full control and the data belongs to you.
 
-![](static/nutshell_1.png)
+However, we believe that something is missing. An element that makes this actually work and ensures that your job postings are found by applicants.
 
-## Structured Data
+![](static/nutshell_1.png){ height="100" }
 
-Because there's **no standard format** (yet) for published job data on websites, job information can vary widely — from a simple list of jobs to a searchable input field to query jobs to an individual pages for each opening. 
+## Structured Meta Data
+
+Because there's **no wide adopted standard format** for published job data on websites, job information can vary widely — from a simple list of jobs to a searchable input field to query jobs to an individual pages for each opening. 
 
 This lack of consistency and structure **makes it difficult for search engines** to accurately recognize the context as job openings.
 
@@ -24,21 +28,16 @@ A simplistic, minimalistic, structured data file containing **meta information**
 
 ## Predefined Path
 
-> How can this data be found?
-
-By placing a metadata file at a **specific**, **predetermined path**, we can ensure that search engines looking for job openings **know exactly where to find the data**. 
+Inspired by robots.txt or sitemap.xml, we place a metadata file at a **specific**, **predetermined path**, we can ensure that search engines looking for job openings **know exactly where to find the data**. 
 
 This means they are aware of the data's context, allowing them to optimize how often they revisit to update their index.
 
 As a result, job openings can be indexed by **multiple search engines** without further efforts and without any additional cost.
 
 ![](static/nutshell_2.png){ height="100" }
 
-
 ## Keep the Control
 
-> Why use metadata instead of full job descriptions?
-
 The metadata you provide will be stored as an index by search engines, we can't control how long they keep that data.
 
 That is why **only as much information as necessary** is provided. This strategy ensures that there is just enough information to pique a candidate's interest and **send them to the employer's website**. 

docs/why.md

@@ -1,39 +1,43 @@
-# What is the Issue?
+# Why
 
-## Expensive
+Let's look at three topics regarding job postings:
 
-> How much will it cost to publish my job opening? Can my company afford that?
+- Costs
+- Convenience
+- Efficiency
+
+## Costs
 
 Publishing and finding jobs is a huge market. Nowadays there are **hundrets or thousands** of job portals, job boards and career platforms world wide. 
 
 An estimated **34.4 USD billion** is spent annually on online job advertisements. This figure for 2023 underscores the immense importance of online job boards and career platforms in modern human resources management. The market for online job ads is a central component of the global recruiting industry. These figures come from Staffing Industry Analysts (SIA), a leading analysis firm in the field of human resources management.
 
 Needless to say, job portals typically **charge employers regardless** of whether they fill the position or not. 
 
-We believe that the search for the right employees should be **free of charge** and should not depend on spending money on job board advertisements.
+We believe that a publishing job offerings is rediculous expensive, it should be **free of charge**.
 
 ??? info "Small selection of well-known job portals"
     Just to name a few: [Indeed](https://www.indeed.com), [LinkedIn](https://www.linkedin.com), [Monster](https://www.monster.com), [Glassdoor](https://www.glassdoor.com), [CareerBuilder](https://www.careerbuilder.com), [ZipRecruiter](https://www.ziprecruiter.com), [Jobrapido](https://de.jobrapido.com), [Simply Hired](https://www.simplyhired.com), [Dice](https://www.dice.com), [Upwork](https://www.upwork.com), [Fiverr](https://www.fiverr.com), [Freelancer](https://www.freelancer.com), [FlexJobs](https://www.flexjobs.com), [Adzuna](https://www.adzuna.com), [StepStone](https://www.stepstone.de), [XING](https://www.xing.com), [Stellenanzeigen.de](https://www.stellenanzeigen.de), [Jobware](https://www.jobware.de), [Meinestadt.de](https://www.meinestadt.de), [Absolventa](https://www.absolventa.de), [Kimeta](https://www.kimeta.de), [JobNinja](https://www.jobninja.com), [Jobs.ch](https://www.jobs.ch), [JobScout24.ch](https://www.jobscout24.ch), [JobUp.ch](https://www.jobup.ch), [Karriere.at](https://www.karriere.at), a.s.o
 
 
-## Inefficient 
-
-### Employers
+## Convenience
 
-> On which job portals should employers publish job openings?
+Employers must decide where and on which of the many, many job portals they want to publish their job vacancies. An account must be created on each platform and all data must be entered separately into each of these portals.
 
-Employers must decide on which of the many, many job portals to publish our job openings. 
+Publishing a job on **multiple portals** often means to *copy/paste* data and **more work to publish and manage**. This can take a lot of time you even pay for. 
 
 It is **not obvious to find the criteria** to decide on which portal they have the best chances to find a candidate.
 
-Publishing a job on **multiple portals** often means to copy/paste data and **more work to publish and manage**.
+We think, this is rediculous unneccessary: As an employer we want to publish the job on **one location** and **spread** the info.
+
+We think, our solution might be the missing piece to make it work.
 
-As an employer, we want to publish the job on **one location** and **spread** the info.
+## Efficiency
 
-### Job Seekers
+Finding job postings online in the web is unnecessarily difficult due to unstructured data. 
 
-> Where to look for a new job? On which job portals? Or should I search the web?
+While there has been some attempts to address this using a job posting schema for jobs, which even Google supports ([Why a new Format](faq.md#why-a-new-format)), it hasn't been widely adopted and **still forces search engines to crawl entire websites** just to find the relevant page. This is like searching an entire library for a single page of a book.
 
-If an employer **can't afford** to pay for a job posting, they might only list the vacancy **somewhere on their own website**. Further, all Google/Bing indexed job openings are often **outdated** because they do or can not distingues normal website content from job openings.
+We propose a much simpler approach, **inspired by conventions** like robots.txt or sitemap.xml. Companies would place all their job listings in a structured file at a single, well-known URL. 
 
-We think, our solution might be the **missing piece to make it work**.
+Job search engines and aggregators would only need to check this one location to get all the data they need. This would make discovering and indexing job postings vastly more efficient for everyone.