Skip to content

docs: add Urdu README - #783

Open
Abdu11ahBilal wants to merge 2 commits into
libredb:mainfrom
Abdu11ahBilal:docs/urdu-readme
Open

docs: add Urdu README#783
Abdu11ahBilal wants to merge 2 commits into
libredb:mainfrom
Abdu11ahBilal:docs/urdu-readme

Conversation

@Abdu11ahBilal

Copy link
Copy Markdown

Description

Adds an abridged Urdu translation of the LibreDB Studio README.

Type of Change

  • Documentation update

Related Issue

Closes #637

Changes Made

  • Added README_ur.md using README_es.md as the structural template.
  • Added Urdu to the language switcher in all README files.
  • Added README_ur.md to the localized README checker.
  • Added right-to-left formatting for Urdu sections.
  • Preserved commands, URLs, product names, and database engine names.

Testing

  • I have tested this locally

  • I have added/updated tests

  • All existing documentation checks pass

  • Validated with:

bun run readme:check

Test Environment

  • OS: Windows
  • Node.js/Bun Version: Bun 1.4.2

Screenshots

Not applicable.

Checklist

  • I have performed a self-review of my changes.
  • I have updated the documentation accordingly.
  • My changes generate no new warnings.
  • New and existing documentation checks pass locally.

Additional Notes

Technical terms and product names remain in English intentionally. Urdu-speaking developers commonly use terms such as Docker, PostgreSQL, Redis, server, and API in English. The explanatory prose has been translated into Urdu, while commands, URLs, and technical names were kept unchanged as required by the issue.

@Abdu11ahBilal

Copy link
Copy Markdown
Author

Hi! The required checks are waiting for maintainer approval because this is my first contribution. Please approve the workflows when convenient. Thank you!

@cevheri cevheri added documentation Improvements or additions to documentation enhancement New feature or request help wanted Extra attention is needed labels Sep 10, 2026
@cevheri

cevheri commented Sep 10, 2026

Copy link
Copy Markdown
Member

Workflows are done. Thanks for the contribution! I’d like to wait for a couple of Urdu-speaking developers to review this before merging. Thanks for your patience!

@cevheri cevheri left a comment

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.

Urdu-speaking developers to review

Comment thread README_ur.md Outdated

<div dir="rtl" align="right">

## <span dir="rtl">فوری آغاز</span>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

this feels like a literal translation of “quick start”. شروع کریں would sound more natural imo

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

I was thinking فوری شروعات؟

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

yeah, either works

Comment thread README_ur.md Outdated

<div dir="rtl" align="right">

<span dir="rtl">تمام SQL engines ایک ہی schema explorer، ER diagrams، schema comparison اور monitoring panels استعمال کرتے ہیں۔ MongoDB اور Redis SQL engines نہیں ہیں: ان میں ER diagram یا schema comparison نہیں ہوتا۔ Druid، Elasticsearch، OpenSearch اور Trino دوہری استثنائی صورتیں ہیں: HTTP پر ان کے SQL interfaces میں کوئی ایسا URI format نہیں ہے جسے یہ build سمجھ سکے، اس لیے انہیں host اور port سے configure کیا جاتا ہے، اور پیدا ہونے والی migrations اس limitation کو بیان کرتی ہیں، بجائے اس کے کہ ایسے engine کے لیے DDL گھڑ دیا جائے جس کے SQL میں column بدلنے کی statements ہی نہیں۔ Couchbase کی schema-less collections کے ساتھ بھی یہی صورت ہے۔ Search clusters کے ER diagram میں boxes تو ہوتے ہیں مگر lines نہیں: indexes foreign keys declare نہیں کرتے، اور engine model میں declare کرنے کے لیے کوئی موجود بھی نہیں۔</span>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

دوہری استثنائی صورتیں ہیں
this is very difficult to understand naturally

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Ill resolve it and try to make it easier. Thank u

Comment thread README_ur.md Outdated

<span dir="rtl">Studio npm package کے طور پر بھی شائع ہوتا ہے، اس لیے اسے براہِ راست آپ کی application میں embed کیا جا سکتا ہے۔ اگر آپ کا product اپنے users کے لیے databases بناتا ہے تو editor کے لیے یہی سب سے مفید جگہ ہے۔</span>

## <span dir="rtl">قیمت کی لکیر کہاں ہے</span>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

this sounds like a direct translation and the meaning isnt immediately clear. maybe کیاfree ہے اور کیاpaid ہے؟

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Thanks for the insight I'll fix this too.

Comment thread README_ur.md
<ul dir="rtl" align="right">
<li><span dir="rtl"><strong>کسی بھی LLM کے ساتھ مطابقت</strong>: default طور پر Gemini استعمال کرتا ہے، اور OpenAI، Ollama اور OpenAI-compatible endpoint (LM Studio، LiteLLM، vLLM) کے ساتھ کام کرتا ہے۔</span></li>
<li><span dir="rtl"><strong><span dir="ltr">Query security analysis</span></strong>: destructive statements (DELETE، DROP، TRUNCATE) کے لیے execution سے پہلے risk evaluation۔</span></li>
<li><span dir="rtl"><strong><span dir="ltr">Query explanation</span></strong>: EXPLAIN plans کو سادہ زبان میں، optimization suggestions کے ساتھ۔</span></li>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

i dont think most urdu speaking developers would use نثری خلاصہ here. text summary or just summary would be fine imo

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Sure I'll change it. 👍🏻

@H4ROOON

H4ROOON commented Sep 10, 2026

Copy link
Copy Markdown

native urdu speaking dev here, i went through the whole readme. overall its understandable but a few terms read very formal or literally translated compared to terms devs use in everyday conversations. ive left a few in line suggestions. other than that, the wording and structure content look good to me

@cevheri

cevheri commented Sep 10, 2026

Copy link
Copy Markdown
Member

native urdu speaking dev here, i went through the whole readme. overall its understandable but a few terms read very formal or literally translated compared to terms devs use in everyday conversations. ive left a few in line suggestions. other than that, the wording and structure content look good to me

Thanks for taking the time to review the whole README and leave these suggestions, really helpful. Our contributor(volunteer:@Abdu11ahBilal ) will go through the notes, and if anyone else would like to take a look, we’d be happy to get more feedback as well.

@Abdu11ahBilal

Copy link
Copy Markdown
Author

Thanks for the review! I’ve addressed all four wording suggestions in README_ur.md and pushed the update.

@Sohaib-Ahmed21

Copy link
Copy Markdown

As a native urdu speaker, I just skimmed through and lgtm.

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

Labels

documentation Improvements or additions to documentation enhancement New feature or request help wanted Extra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add an Urdu README (README_ur.md), covered by the localized-README drift guard

4 participants