diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..f4bc413 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,34 @@ +# EditorConfig helps maintain consistent coding styles +# https://editorconfig.org + +root = true + +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true +indent_style = space +indent_size = 2 + +[*.md] +trim_trailing_whitespace = false +max_line_length = off + +[*.{yml,yaml}] +indent_size = 2 + +[*.{js,jsx,ts,tsx,json}] +indent_size = 2 + +[*.{php,blade.php}] +indent_size = 4 + +[*.{py}] +indent_size = 4 + +[*.{sh,bash}] +indent_size = 2 + +[Makefile] +indent_style = tab diff --git a/.github/workflows/link-check-config.json b/.github/workflows/link-check-config.json new file mode 100644 index 0000000..7bd95b6 --- /dev/null +++ b/.github/workflows/link-check-config.json @@ -0,0 +1,11 @@ +{ + "ignorePatterns": [ + { + "pattern": "^https://github.com/search" + } + ], + "timeout": "20s", + "retryOn429": true, + "retryCount": 3, + "fallbackRetryDelay": "30s" +} diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml new file mode 100644 index 0000000..eb011b4 --- /dev/null +++ b/.github/workflows/validate.yml @@ -0,0 +1,54 @@ +name: Validate Profile + +on: + push: + branches: [ main, develop ] + pull_request: + branches: [ main ] + workflow_dispatch: + +jobs: + validate: + name: Validate README and Links + runs-on: ubuntu-latest + permissions: + contents: read + + steps: + - name: Checkout repository + uses: actions/checkout@v4 + + - name: Check for required files + run: | + echo "Checking for required files..." + test -f README.md || (echo "❌ README.md not found" && exit 1) + test -f .gitignore || (echo "⚠️ .gitignore not found" && exit 0) + test -f .editorconfig || (echo "⚠️ .editorconfig not found" && exit 0) + echo "✅ All required files present" + + - name: Validate Markdown syntax + uses: DavidAnson/markdownlint-cli2-action@v15 + with: + globs: '**/*.md' + config: | + { + "default": true, + "MD013": false, + "MD033": false, + "MD041": false + } + + - name: Check for broken links + uses: gaurav-nelson/github-action-markdown-link-check@v1 + with: + use-quiet-mode: 'yes' + use-verbose-mode: 'no' + config-file: '.github/workflows/link-check-config.json' + check-modified-files-only: 'no' + + - name: Report success + if: success() + run: | + echo "✅ All validation checks passed!" + echo "📄 README.md is valid" + echo "🔗 All links are working" diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..4e0b355 --- /dev/null +++ b/.gitignore @@ -0,0 +1,62 @@ +# Operating System Files +.DS_Store +.DS_Store? +._* +.Spotlight-V100 +.Trashes +ehthumbs.db +Thumbs.db +*~ + +# IDE and Editor Files +# .vscode/ - keeping for workspace configuration +.idea/ +*.swp +*.swo +*.swn +.project +.classpath +.settings/ +*.sublime-project +*.sublime-workspace + +# Temporary Files +*.log +*.tmp +*.temp +.cache/ +tmp/ +temp/ + +# Node.js (if using npm/yarn for any tooling) +node_modules/ +npm-debug.log* +yarn-debug.log* +yarn-error.log* +package-lock.json +yarn.lock + +# Python (if using Python scripts) +__pycache__/ +*.py[cod] +*$py.class +*.so +.Python +venv/ +ENV/ +env/ +.venv + +# Build outputs +dist/ +build/ +*.egg-info/ + +# Environment variables +.env +.env.local +.env.*.local + +# Backup files +*.bak +*.backup diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 0000000..a4ae011 --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,9 @@ +{ + "recommendations": [ + "editorconfig.editorconfig", + "yzhang.markdown-all-in-one", + "davidanson.vscode-markdownlint", + "github.vscode-pull-request-github", + "eamodio.gitlens" + ] +} diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..fdf982d --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,22 @@ +{ + "editor.formatOnSave": true, + "editor.rulers": [80, 120], + "editor.tabSize": 2, + "editor.insertSpaces": true, + "files.trimTrailingWhitespace": true, + "files.insertFinalNewline": true, + "files.eol": "\n", + "[markdown]": { + "editor.wordWrap": "on", + "editor.quickSuggestions": false, + "files.trimTrailingWhitespace": false + }, + "[php]": { + "editor.tabSize": 4 + }, + "[python]": { + "editor.tabSize": 4 + }, + "markdown.extension.toc.levels": "2..6", + "markdown.extension.preview.autoShowPreviewToSide": false +} diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..18737f5 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,95 @@ +# Contributing to Karona Profile + +Thank you for your interest in contributing to this profile repository! + +## 🎯 Purpose + +This repository serves as a personal profile/portfolio README for Karona, showcasing professional experience, skills, and projects. + +## 📋 How to Contribute + +### Reporting Issues + +If you notice any issues with the profile: +1. Check if the issue already exists +2. Create a new issue with a clear description +3. Include screenshots if applicable + +### Suggesting Changes + +To suggest changes: +1. Fork the repository +2. Create a new branch (`git checkout -b feature/improvement`) +3. Make your changes +4. Test that all links work +5. Submit a pull request + +## ✅ Guidelines + +### Content Guidelines + +- Keep information professional and accurate +- Maintain the existing structure and format +- Use proper Markdown syntax +- Ensure all links are working and relevant + +### Coding Standards + +- Follow the `.editorconfig` settings +- Use consistent formatting +- Write clear commit messages +- Keep changes focused and minimal + +### Commit Messages + +Use the following format: +``` +: + + +``` + +Types: +- `docs`: Documentation changes +- `feat`: New feature or content +- `fix`: Bug fixes or corrections +- `style`: Formatting changes +- `refactor`: Code restructuring + +Example: +``` +docs: Update technical skills section + +Added new frameworks and tools used in recent projects. +Updated cloud services list with current platforms. +``` + +## 🔍 Review Process + +1. All pull requests will be reviewed +2. Feedback will be provided if changes are needed +3. Once approved, changes will be merged + +## 📞 Questions? + +Feel free to reach out via email: karonanat@gmail.com + +## 📜 Code of Conduct + +### Our Standards + +- Be respectful and professional +- Provide constructive feedback +- Focus on the content, not the person +- Maintain confidentiality of personal information + +### Unacceptable Behavior + +- Harassment or discrimination +- Personal attacks +- Publishing private information +- Unprofessional conduct + +## 🙏 Thank You + +Your contributions help keep this profile accurate and up-to-date! diff --git a/README.md b/README.md index 9a65f4d..f470ae5 100644 --- a/README.md +++ b/README.md @@ -1 +1,87 @@ -# Karona \ No newline at end of file +# Karona +# 👋 Hi, I’m Karona + +**Full-Stack Web Developer | DevOps Engineer** + +--- + +I’m a passionate software developer with over 4 years of experience building and maintaining robust applications. My expertise lies in PHP and the Laravel ecosystem, with a keen interest in delivering scalable solutions. I thrive on complex challenges, from backend development to DevOps and cloud infrastructure. + +--- + +## 🛠️ Technical Skills + +- **Programming:** Bash, PHP, JavaScript, CSS, HTML, Bootstrap, jQuery, Tailwind CSS +- **Frameworks/Patterns:** Laravel, Livewire, Filamentphp, Vue.js +- **Database:** MySQL, PostgreSQL +- **Networking:** LAN/WAN design, Internet/IP configuration +- **Operating Systems:** Windows, Mac OS, Linux, Ubuntu Server +- **Platforms/Tools:** GitLab, GitHub +- **Cloud Services:** AWS, Digital Ocean, Cloudflare + +--- + +## 💼 Work Experience + +- **Ministry Of Women’s Affairs** + - Assistant to H.E Sivann Butom, Secretary of State *(2018 - 2019)* +- **PIDAUR FUND PLC** + - Credit Officer & Auditor *(2019 - 2021)* +- **Pethyoeung Healthtech Co., LTD** + - Web Developer & DevOps *(2021 - Present)* + +--- + +## 🚀 What I Do + +**DevOps** +- Code deployment, versioning, and system releases for hospital and health systems +- Ubuntu server setup (offline & online) +- Client access configuration +- Bug resolution and server troubleshooting +- Backup configuration and cron scheduling +- Database optimization & analytics +- System performance monitoring + +**Development** +- Implement new features & bug fixes for Hospital, Dental, Blood Bank systems +- API integration between health systems (Blood Bank ↔ Hospital, Hospital ↔ Pharmacy) +- Optimize queries and enhance system reliability + +--- + +## 📣 Featured Projects + +Here are some recent public repositories I’m involved in or recommend checking out: +- [csharp-devcontainer-template](https://github.com/itallo1122/csharp-devcontainer-template) — Beginner-friendly C# dev container for Ubuntu + VS Code +- [auto-dev](https://github.com/unit-mesh/auto-dev) — AI-powered coding wizard (autogeneration, multilingual, bug assistant) +- [chips-devtest-terraform](https://github.com/companieshouse/chips-devtest-terraform) — Infrastructure as Code for dev & test environments +- [80lv.webAutomation](https://github.com/ashfaq-viva/80lv.webAutomation) — Playwright E2E test automation for scalable web testing + +> _See all projects at [my public GitHub search](https://github.com/search?q=dev-testing-code+is:public&sort=updated&order=desc)_ + +--- + +## 🌱 Interests + +- Researching and learning new tech +- E-learning & continual upskilling +- Exploring new travel spots + +--- + +## 📫 Contact + +Feel free to reach out for collaboration, consulting, or just to connect: + +**Email:** karonanat@gmail.com + +--- + +*“Delivering reliable, scalable, and innovative solutions — every day.”* + +## 🔧 Repository Info + +This repository includes a complete workspace configuration: +- See [WORKSPACE.md](WORKSPACE.md) for setup instructions +- See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines diff --git a/WORKSPACE.md b/WORKSPACE.md new file mode 100644 index 0000000..5790434 --- /dev/null +++ b/WORKSPACE.md @@ -0,0 +1,143 @@ +# Workspace Setup Guide + +This document provides instructions for setting up and working with this repository. + +## 🚀 Getting Started + +### Prerequisites + +This is primarily a profile repository, but if you want to contribute or work with it locally: + +- Git installed on your machine +- A text editor or IDE (VS Code, Sublime Text, etc.) +- Basic knowledge of Markdown + +### Clone the Repository + +```bash +git clone https://github.com/dev-testing-code/Karona.git +cd Karona +``` + +## 📝 Making Changes + +### Editing the Profile + +The main content is in `README.md`. To make changes: + +1. Open `README.md` in your preferred editor +2. Make your changes +3. Preview the Markdown to ensure proper formatting +4. Commit and push your changes + +### Code Style + +This repository uses: +- **EditorConfig** for consistent formatting across editors +- **Markdown** for documentation +- Follow the existing structure and style in README.md + +## 🔧 Development Tools + +### Recommended VS Code Extensions + +If using VS Code, consider installing: +- Markdown All in One +- markdownlint +- EditorConfig for VS Code + +### Editor Configuration + +The repository includes: +- `.editorconfig` - Maintains consistent coding styles +- `.gitignore` - Excludes unnecessary files from version control + +## 🤝 Contributing + +### Making Updates + +1. Create a new branch for your changes: + ```bash + git checkout -b feature/your-feature-name + ``` + +2. Make your changes and commit: + ```bash + git add . + git commit -m "Description of changes" + ``` + +3. Push your changes: + ```bash + git push origin feature/your-feature-name + ``` + +### Commit Message Guidelines + +- Use clear, descriptive commit messages +- Start with a verb (Add, Update, Fix, Remove, etc.) +- Keep the first line under 50 characters +- Add detailed description if needed + +Example: +``` +Update technical skills section + +- Added new frameworks +- Updated cloud services list +- Reorganized programming languages +``` + +## 📋 File Structure + +``` +Karona/ +├── .editorconfig # Editor configuration +├── .gitignore # Git ignore rules +├── README.md # Main profile content +└── WORKSPACE.md # This file +``` + +## 🛠️ Maintenance + +### Regular Updates + +Keep your profile up to date by regularly reviewing and updating: +- Work experience +- Technical skills +- Featured projects +- Contact information + +### Best Practices + +- Keep the README concise and scannable +- Use emoji sparingly for visual interest +- Ensure all links are working +- Update project links to reflect recent work + +## 📚 Resources + +### Markdown References +- [GitHub Flavored Markdown](https://github.github.com/gfm/) +- [Markdown Guide](https://www.markdownguide.org/) + +### Profile Inspiration +- [Awesome GitHub Profile README](https://github.com/abhisheknaiidu/awesome-github-profile-readme) +- [GitHub Profile README Generator](https://rahuldkjain.github.io/gh-profile-readme-generator/) + +## 🔍 Validation + +Before committing changes, ensure: +- [ ] Markdown syntax is correct +- [ ] All links are working +- [ ] Content is up to date +- [ ] No sensitive information is exposed +- [ ] Formatting is consistent + +## 📞 Support + +For questions or issues, contact: karonanat@gmail.com + +--- + +*Last updated: October 2025*