Skip to content

UI: Refactor Hosting Policy page#1121

Open
rosalieper wants to merge 2 commits intomainfrom
T422593
Open

UI: Refactor Hosting Policy page#1121
rosalieper wants to merge 2 commits intomainfrom
T422593

Conversation

@rosalieper
Copy link
Copy Markdown
Contributor

Bug: T422593

@github-actions
Copy link
Copy Markdown

Deployment previews on netlify for branch refs/pull/1121/merge will be at the following locations (when build is done):

Copy link
Copy Markdown
Member

@outdooracorn outdooracorn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Managed to do a quick review.

I would comment out all the custom CSS and see how far you can get with Vuetify-native CSS classes. Reach out for collaboration if that is proving difficult. If we have to add custom CSS we should also write a comment explaining why it was necessary.

Comment thread src/components/Pages/HostingPolicy.vue Outdated
Comment thread src/components/Pages/HostingPolicy.vue Outdated
Comment thread src/components/Pages/HostingPolicy.vue Outdated
Copy link
Copy Markdown
Member

@outdooracorn outdooracorn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Another quick review with some nitpicks. We are getting there :D

Comment thread src/components/Pages/HostingPolicy.vue Outdated
Comment thread src/components/Pages/HostingPolicy.vue Outdated
Comment thread src/components/Pages/HostingPolicy.vue Outdated
Copy link
Copy Markdown
Member

@outdooracorn outdooracorn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry, I wasn't very clear that we should remove all the strong and em elements unless the text is conveying importance or emphasis. Ask yourself, "if I was reading this sentence out loud, would I shout or otherwise emphasizes that part of the sentence?". If not, then the bold and/or italic styling should be done via CSS classes.

I've added some suggestions to provide more examples to go off, but I haven't done them all.

<h3 class="mb-3 mt-6" id="target-audience">1.1 Target Audience</h3>
<ul class="mb-4">
<li>Primary audience: the <a class="font-weight-bold font-italic" href="#review-committee">Review Committee</a> responsible for reviewing and approving Wikibase Cloud hosting requests for continued use. The policy provides a shared framework for making consistent, transparent decisions grounded in mission alignment, resource realities, and inclusivity goals.</li>
<li>Secondary audience: <strong>Wikibase Cloud's current and prospective users</strong>, who can use this document to understand the reasoning behind WMDE’s hosting criteria and to self-assess whether their use case is likely to be accepted.</li>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<li>Secondary audience: <strong>Wikibase Cloud's current and prospective users</strong>, who can use this document to understand the reasoning behind WMDE’s hosting criteria and to self-assess whether their use case is likely to be accepted.</li>
<li>Secondary audience: <span class="font-weight-bold">Wikibase Cloud's current and prospective users</span>, who can use this document to understand the reasoning behind WMDE’s hosting criteria and to self-assess whether their use case is likely to be accepted.</li>

</ul>
<h3 id="relationship-to-other-governance-documents">1.2 Relationship to other governance documents</h3>
<h3 class="mb-3" id="relationship-to-other-governance-documents">1.2 Relationship to other governance documents</h3>
<p><em>(These relationships matter to ensure hosting criteria remain coherent with other governance documents, prevent contradictory expectations for contributors, and avoid overlap between responsibilities of WMDE, WMF, and individual communities.)</em></p>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<p><em>(These relationships matter to ensure hosting criteria remain coherent with other governance documents, prevent contradictory expectations for contributors, and avoid overlap between responsibilities of WMDE, WMF, and individual communities.)</em></p>
<p class="font-italic">(These relationships matter to ensure hosting criteria remain coherent with other governance documents, prevent contradictory expectations for contributors, and avoid overlap between responsibilities of WMDE, WMF, and individual communities.)</p>

<p><em>(These relationships matter to ensure hosting criteria remain coherent with other governance documents, prevent contradictory expectations for contributors, and avoid overlap between responsibilities of WMDE, WMF, and individual communities.)</em></p>
<ul>
<ul class="pl-5 mb-3">
<li>This policy complements the <strong><a href="/terms-of-use">Wikibase Cloud Terms of Use</a></strong>, which define the legal and compliance conditions for using the platform.</li>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<li>This policy complements the <strong><a href="/terms-of-use">Wikibase Cloud Terms of Use</a></strong>, which define the legal and compliance conditions for using the platform.</li>
<li>This policy complements the <a class="font-weight-bold" href="/terms-of-use">Wikibase Cloud Terms of Use</a>, which define the legal and compliance conditions for using the platform.</li>

<h3 class="mb-3" id="relationship-to-other-governance-documents">1.2 Relationship to other governance documents</h3>
<p><em>(These relationships matter to ensure hosting criteria remain coherent with other governance documents, prevent contradictory expectations for contributors, and avoid overlap between responsibilities of WMDE, WMF, and individual communities.)</em></p>
<ul>
<ul class="pl-5 mb-3">
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we do the same as #1121 (comment) for all these top level ul elements, please?

Suggested change
<ul class="pl-5 mb-3">
<ul class="mb-4">

</ul>
<div>
<v-alert colored-border type="warning" prominent border="left" elevation="2">
<ul class="mb-1">
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As this is in an alert and has sufficient margins/padding, I don't think we need to add any more.

Suggested change
<ul class="mb-1">
<ul>

<v-alert color="info" text >
<p id="assessing-size-and-load"><strong>Assessment of size and load</strong></p>
<p>Wikibase Cloud does not operate with fixed numerical limits for dataset size or traffic at this stage. Decisions about size and load will be made empirically, based on observed platform behavior and past incidents. When an instance creates significant strain on the infrastructure, the situation will be investigated, discussed with the instance manager and documented in a public log together with the decision taken.</p>
<p>If a high-load use case is meaningful, the Review Committee may assess whether technical improvements and the effort to make them are reasonable. If they are, the use case will only produce a <em><a href="#concerning-signals">Concerning Signal</a></em>. Over time, documented cases will inform future decisions, creating a growing body of precedent. In all cases, instance managers will be contacted and involved in finding a reasonable solution before further action is taken.</p>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants